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WELCOME | Magi 


WELCOME 
to The MagP1 104 


elcome to the future. 2021 is a sci-fi year and science 

promised us hoverboards, jet packs, and robot butlers. 

We can’t do much about the first two (although we’re 
keeping an eye out). But help around the home is definitely our 
domain. In this issue we asked resident home automation expert PJ 
Evans to design our home of the future with Raspberry Pi (page 34). 
The result is a fabulous collection of widgets, projects, and gizmos to 
help around the house. I’ve already talked Rosie into installing some 
NeoPixel steps at home. 





Lucy 
Hattersley 





Lucy is editor of The 
MagPi magazine and 


Meanwhile Rob has been looking how to take a Raspberry P1 i nineaie 


her south London 


project and turn it into a Pico project (page 72). KG has started to nome Mor nape: 
@LucyHattersley 


build an arcade machine (page 42). Nicola has been looking at an 
autonomous home robot (page 20). Me? I’ve been playing around 
with ARM assembly like the nerd I am (page 84). 

This issue has been a huge amount of fun! And we particularly like 
the illustration adorning this month’s cover. Thanks to Sam Alder Cia 









for incredible drawing skills (and Sam Ribbits for laying it out). RASPBERRY PI 
Enjoy this month’s edition and ZERO W KIT 

let us Know what you do with 1 your OFFICIAL RASPBERRY F MAGAZINE { 

your home. ) The 


Lucy Hattersley Editor 
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Subscribe to The MagPi, HackSpace magazine, or Custom PC. Your first three issues for £10, then our great value rolling subscription 
afterwards. Includes a free voucher for one of five fantastic books at store.rpipress.cc/collections/latest-bookazines 
UK only. Free delivery on everything. 
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Autonomous Home Robot 





DISCLAIMER: Some of the tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While 
we attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. Raspberry 
Pi (Trading) Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi magazine. Laws and regulations 
covering many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible for understanding the requirements in your 
jurisdiction and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some projects or suggestions in The MagPi magazine may go 
beyond. It is your responsibility to understand the manufacturer's limits. 
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StereoPi is an open source stereoscopic 
camera, based on Raspberry Pi. 
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This is the friendliest way to play with 
the stereoscopic vision for the spatially 
aware robots, 3D photo and video! 


oF © 


Raspbian 
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Buy in Canada: jo] 





BuyaPi.ca/stereopi 





RASPBERRY Pl INSIDE STOCK RASPBIAN OPEN SOURCE CROWDFUNDED 
SUPPORT PROJECT 

LinuxGizmos.com MickMake Raspberry Pi Blog Hackster News 
“The StereoPi can capture, save, “With it you can do things like, stream “There are some excellent “You can hook this up to YouTube, 
livestream, and process real-time stereoscopic 3D video to YouTube, build community efforts too, of to Oculus Go, you can use it with 
stereoscopic video and images for real-time depth maps using OpenCV, which our current OpenCvV.. | cannot wait to start 
robotics, AR/VR, computer vision, drone create panoramics using Hugin and even favourite is this nifty dual messing around with these because 
instrumentation, and panoramic video.” a 3rd person view of real life. Cool.” camera board.” it’s basically a dream come true.” 


Elettronica In p- & LinuxGizmos.com © Geeky Gadgets 





OPENELECTRONICS iV) #9 electronics-lab 


Magri | PROJECT SHOWCASE 





Guy Dupont 





A software and 
mobile phone 
developer, Guy 
enjoys acquiring 
new skills 

while tackling 
tech projects. 


magpi.cc/ 
ipodspotify 





Warning! 
Conductive 
electricity 


If you're upcycling an 
MP3 player with a metal 
case, make sure you 
tape off the conductive 
components so you 
don't short-circuit them. 


magpi.cc/ 
electricalsafety 


> This project streams 
music using Spotify 
using an API from 
the music service's 
development page 


1Pod Classic 
Spotify player 


Recreating Apple's iconic Pod Classic as a Spotify player may seem like 
Sacrilege, Dut it works surprisingly well, Rosie Hattersley listens in 


hen the original iPod was launched, 
W the idea of using it to run anything 

other than iTunes seemed almost 
blasphemous. The hardware remains a classic, 
but our loyalties are elsewhere with music services 
these days. If you still love the iPod but aren’t 
wedded to Apple Music, Guy Dupont’s Spotify 
hack makes a lot of sense. “It’s empowering as a 
consumer to be able to make things work for me 
— no compromises,” he tells us. His iPod Classic 
Spotify player project cost around $130, but you 
could cut costs with a different streaming option. 

“T wanted to explore what Apple’s (amazing) 

original iPod user experience would feel like in 
a world where we have instant access to tens of 
millions of songs,” he says. “And, frankly, it was 
really fun to take products from two competitors 
and make them interact in an unnatural way.” 


=) Spotify for Developers 


a 





Guy’s career spans mobile phone app 
development, software engineering, and time 
in recording studios in Boston as an audio 
engineer, so a music tech hack makes sense. 
He first used Raspberry Pi for its static IP so he 
could log in remotely to his home network, and 
later as a means of monitoring his home during 
a renovation project. Guy likes using Raspberry 
Pi when planning a specific task because he 
can “program [it] to do one thing really well... 
and then I can leave it somewhere forever”, in 
complete contrast to his day job. 


Mighty micro 

Guy seems amazed at having created a Spotify 
streaming client that lives inside, and can be 
controlled by, an old iPod case from 2004. He even 
recreated the iPod’s user interface in software, 


ISE CASES Q 
Teens 


Create & manage your Spotify 


integrations. 


Meat your dashboard. Log in to create néw integrations and manage your Spotify cradantials. Just connect 


Spotify Developer to your Spotify account. 
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Raspberry Pi Zero W connected toa 
Spotify Premium account 
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Guy hacked his 
RV by adding a 
Raspberry Pi 
media server... 


much to the 
surprise of Its 
co-owner (his dad!) 


He's also Raspberry 
Pi-enabled his 
record player... 





it streams albums 
around the house 


Just like the iPod Classic, running a 
slave Lola cele lave msal-mel (el @vdal-1=1m eco) ks 


dalcoleCelamtal-malci me) mie-\el <oRe) are l ad ()m— Daciwae Gneur 


the first devices to 
use the VideoCore 
processor found in 
Raspberry Pi 
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A Guy managed to use a font for the music library that looks 
almost exactly the same as Apple's original 





tight down to the font. A ten-year-old article M |t's really empowering as g consumer 
about the click wheel provided some invaluable 
functionality insights (magpi.cc/ipodclickwheel) to be able to make things work for Me 


and allowed him to write code to control it in C. 
Guy was also delighted to discover an Adafruit 
display that’s the right size for the case, doesn’t 
expose the bezels, and uses composite video input 
so he could drive it directly from Raspberry Pi’s 
composite out pins, using just two wires. “If you’re 
not looking too closely, it’s not immediately obvious 
that the device was physically modified,” he grins. 

Guy’s retro iPod features a Raspberry Pi Zero W. 
“Tm not sure there’s another single-board 
computer this powerful that would have fit in this 
case, let alone one that’s so affordable and readily 
available,” he says. “Raspberry Pi did a miraculous 
amount of work in this project.” The user interface 
is a Python app, while Raspberry Pi streams music 
from Spotify via Raspotify (magpi.cc/raspotify), 
reads user input from the iPod’s click wheel, and 
drives a haptic motor — all at once. 

Most of the hardware for the project came from 
Guy’s local electronics store, which has a good A Guy previously used Raspberry Pi to stream albums around his home 


- no compromises @ 
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CS Raspberry Pi (Pico) =74 Components 


Extension Family 


Make Your Project Smarter With Pico’s Expansions DIY Kits 


Breadboard Kit GPIO Expansion HAT Expansion 


All in one Raspberry Pi Pico Raspberry Pi Pico GPIO Connects any 
kit with onboard LEDs, expander to access GPIO Raspberry Pi HAT with 


button, buzzer & breadboard pins easily. Raspberry Pi Pico. 


FOR MORE INFO, PLEASE VISIT : SHOP.SB-COMPONENTS.CO.UK 








RasPad 3 








A Portable Raspberry Pi 
Pad to Learn & Program 
in Mins 





Get it at 


SD Card Slot ermet_USB__ HDMI NT Te 


Power Button ——— 


_ Volume 
em =f-14%-1 0 
Be 





MagPi 


Music on the move 





Carefully open up the MP3 player you're 

repurposing, remove its existing components, 
retaining anything you'll reuse, then check the 
replacement parts will fit within the chassis. 





Install the C-based haptic code on Raspberry 

Pi Zero. Connect Raspberry Pi, display, headers, 
and leads. Then power on and check the click wheel Impressively, the click wheel 
data is recognised and drives the haptic motor. POL OMING MGC HADI aT WO 


line in Raspberry Pi and Adafruit components. He 
just like the iPod Classic's had a couple of attempts to get the right size of 
haptic motor, but most things came together fairly 
easily after a bit of online research. Help, when 

he needed it, was freely given by the Raspberry Pi 
community, which Guy describes as “incredible”’. 


Things just clicked 

Part of the fun of this project was getting the 

iPod to run anon-Apple streaming service, so 

he’d also love to see versions of the iPod project 

using different media players. You can follow his 

instructions on GitHub (magpi.cc/ipodspotify). 
Next, Guy intends to add a DAC (digital to 





Tape off any conductive elements in the case 


to prevent short-circuiting. Test Raspotify and analogue converter) for the headphone jack, but 
install on Raspberry Pi Zero before mounting it in your Bluetooth works for now, even connecting from 
new music player and powering it up. inside his jacket pocket, and he plans to get an 


external USB DAC in time. 
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200 PAGES OF RASPBERRY PI 








® Get started with Raspberry Pi, ® Learn how to code and make 
electronics, and more with our step-by-step tutorials 


® Be inspired by incredible ® Find out about the top kits and 
projects made by other people accessories for your projects 
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Food Computer 


Rob Zwetsloot talks to teacher Chris Regini about the incredible 
project that his students are working on 





Noah Kay and 
Noah Berlin 


Eighth grade 
students at West 
Hollow Middle 
School in Long 
Island, New 

York that are the 
leads on this 
Food Computer. 
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hen we think of garden automation here 

at The MagPi, we often think of basic 

measures like checking soil moisture 
and temperature. The Kay-Berlin Food Computer, 
named after student creators Noah Kay and Noah 
Berlin, does a lot more than that. A lot more. 

“Tt is a fully automated growth chamber that can 
monitor over a dozen atmospheric and root zone 
variables and post them to an online dashboard 
for remote viewing,” Chris Regini tells us. He’s 
supervising both Noahs in this project. “In addition 
to collecting data, it is capable of adjusting fan 
speeds based on air temperature and humidity, 
dosing hydroponic reservoirs with pH adjustment 
and nutrient solutions via peristaltic pumps, dosing 
soil with water based on moisture sensor readings, 
adjusting light spectra and photoperiods, and 


At night, an IR LED floodlight allows 
for infrared camera monitoring via a 
Raspberry Pi NolIR Camera Module 


Kay-Berlin Food Computer 


capturing real-time and time-lapsed footage using a 
[Raspberry Pi] NoIR Camera Module in both daylight 
and night-time growth periods.” 

Everything can be controlled manually or set to 
be autonomous. This isn’t just keeping your garden 
looking nice, this is the future of automated farming. 


Seeds of knowledge 

“The idea originated from the long-standing MIT 
food computer project and lots of open-source 
collaboration in both the agriculture and Raspberry 
Pi communities,” Chris explains. “We’ve always had 
the hopes of creating an automated growing system 
that could collect long-term data for use in the ISS 
during space travel, or in terrestrial applications 
where urbanisation or climate concerns required the 
erowth of food indoors.” 






Pumps control water flow, 
along with other liquids 
designed to aid the plants 
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The project began 
in late 2019 


An IR LED 
illuminates the 
farm at night 
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The project makes 
use of a MARSfarm 
classroom 
greenhouse kit 


Atla s§ a (= ntific Chris has also 






ital Robotics planned lessons 
with the projects 
website and 
FutureLearn 
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Calibration of 
Py) sensors can be 
aan done remotely 









an , “* Nath E 
Kay-Berlin Food Cerh ute 


— 
bala 
rat 


ea 
iA 
ay:/ 


Ms Magi | PROJECT SHOWCASE 





16 | magpicc | Kay-Berlin Food Computer 


There are six plants in the box, allowing for a lot of data collection 


With students doing a lot of learning from home in 
the past year, having such a system accessible online 
for interaction was important for Chris: “Adding 
a layer that could keep students engaged in this 
endeavour during remote learning was the catalyst 
that truly spurred on our progress.” 

This level of control and web accessibility is perfect 
for Raspberry Pi, which Chris, his students, and his 
Code Club have been using for years. 

“The fact that we had access to the GPIOs 
for sensors and actuators, as well as the ability 
to capture photo and video was great for our 
application,” Chris says. “Being able to serve the 
collected data and images to the web, as well as 
schedule subroutines via systemd, made it the 
perfect fit for accessing our project remotely and 
having it run time-sensitive programs.” 

The computer has been in development for a 
while, but the students working on it have a wide 
range of skills that have made it possible. 

“We have had a dedicated nucleus of students that 
have spent time learning plant science, electronic 
circuitry, Python, developing UIs, and creating 
housings in CAD,” Chris explains. “They all started 
as complete beginners and have benefited greatly 
from the amazing tutorials available to them through 
the Raspberry Pi Foundation website, as well as the 
courses offered on FutureLearn.”’ 


1 : i 
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A Construction and 
programming has occurred 
in person and remotely 





m™ The system does a fantastic job collecting 
data and allowing us to visualise It via our 
Adatruit 10+ dashboards @ 


Grow beyond 
The project is ongoing — although they’ re already 
eetting a lot of data that is being used for 
citizen science. 

“The system does a fantastic job collecting data 
and allowing us to visualise it via our Adafruit 
10+ dashboards,” Chris says. “Upgrading our 
sensors and actuators to more reliable and 
accurate models has allowed the system to 
produce research level data that we are currently 
sharing ina citizen science project called Growing 
Beyond Earth. It is funded by NASA and is 
organised through Fairchild Botanical Gardens. 
We have been guided along the way by industry 
professionals in the field of hydroponics and have 
also collaborated with St Louis-~based MARSfarm 
to upgrade the chamber housing, reflective 
acrylic panels, and adjustable RGBW LED panel. 
Linking our project with scientists, engineers, 
researchers, and entrepreneurs has allowed it to 
really take off.” 
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Food science in action 






“The entire system has a network of sensors... 

01 ee | ee , 
which monitor atmospheric variables of air 

temperature, humidity, COz, Oz, and air pressure. 

Root zone variables include soil moisture by way 

of capacitive resistance sensors, reservoir levels 

by way of float switches, water/soil temperature, 

water/soil pH, nutrient levels by way of EC, 

dissolved oxygen, and water quality/root health by 

way of ORP (oxidation reduction potential).” 
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02 With this data, the computer controls an array 
of pumps that provide water, nutrients, and pH 
adjustments. Grow lights are controlled and tweaked, 
fans are adjusted, heating mats activated, and it even 
switches between day and night vision for the camera. 





“All data is viewable in real time and historically, 
O3 ie | 

while all actuators are controllable via our 
Adafruit |O dashboard. Adjustment parameters like 
RGBW light spectrum, photoperiod, fan speed, pH and 
temperature set points, and liquid dosing volumes can 
be chosen here as well.” 
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A When the arm is spun rapidly, the 
LEDs are blinked rapidly in a pattern 
to display a still or moving image 





Putting Raspberry Pi Pico in a spin, this rotating LED arm can show 
moving images. Phil King ponders whether seeing Is believing 





HomeMade 
Garbage 


A family team of 
two children and a 
couple. They live on 
a handmade basis. 
Dad is good at 
electronic work, 
and mom is 

good at music 
production and 
web technology. 
Children are good at 
growing up well. 


magpi.cc/garbage 
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phenomenon in which the illusion of 
motion is created because the human brain 
- which can only process 10-12 frames per second 
— interprets a rapid sequence of still pictures as 
a continuous moving image. It’s the basis of how 
animation works, as well as film and TV in general. 
By rotating a strip of LEDs at high speed and 
syncing their blinking patterns, it’s possible to 
create the illusion of a still or moving image. This 
is just what Japan-based family team of makers 
HomeMadeGarbage have done for their POV Display 
(magpi.cc/povdisplay), even spinning a Raspberry 
Pi Pico around with the LED strips. 


p ersistence of vision (POV) is the optical 


Power of PIO 

The makers tell us that, after creating a similar 
project using Sony’s considerably more expensive 
Spresense board, they were inspired to try it with 
Pico, as they were “very surprised at the parallel 
high-speed operation of PIO.” The latter is the 
unique Programmable Input/Output feature of 
Pico’s RP2040 chip that enables the use of custom 
communication protocols in addition to the built-in 
I2C and SPI. This offers a faster way of outputting 
bit-banged data (even video) to non-standard 
devices with a deeper level of control, without tying 
up the main processor. 


The POV Display uses two different PIO state 
machines (from the eight available on the chip) to 
control, in parallel, a pair of super-bright 24-LED 
APA102 (aka DotStar) strips on its rotating arm. The 
arm is spun at high speed by a Mabuchi RS-540SH 
motor, as commonly used in remote-control cars. 

Each rotation is detected using a reflectance 
sensor on the arm and a small white marker 
underneath. HomeMadeGarbage say that they 
improved detection reliability by inserting “a filter 
and a Schmitt trigger between the reflectance 
sensor and Pico to prevent chattering.” 

In the software, written in C, the time taken 
for one rotation is divided by 1000 to sync the 


™ They've managed to spin the 
arm at up to 960rpm while 
displaying an image at 1000 
frames per rotation @ 


blinking of LED patterns stored in a graphics 
array. “In order to leave a beautiful after-image, 

a speed of ten revolutions or more per second is 
required,” reveal HomeMadeGarbage. Discovering 
that “the I/O of Raspberry Pi Pico can run very 
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the rotating arm, Raspberry 
Pi Pico controls the LEDs 











Two 24-LED APA102 strips 
'o) tla) r= e=)V,areralcelalix=xe 

pattern to show an image 
as the arm rotates 
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> The project 
took four days 


e)\i-) Koll ea (exer-lale mtal= to complete 


LEDs is supplied via a 
wireless charging module 1} > The LED pattern 








is updated 1000 
times per rotation 
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this example: 
fast’, they’ve managed to spin the arm at up to underside of the arm centre. “5V is supplied to the magpi.cc/ 
960rpm while displaying an image at 1000 frames transmitting side of the wireless charging module, picoapaio2zcode 
per rotation. and the receiving side receives the voltage, [which] 

drives Pico, sensor, and LEDs.” 

Spinning around After posting a video of the POV Display in 
With everything, including Raspberry Pi Pico, action, HomeMadeGarbage found that people were 
whizzing around at high speed, you may well “surprised at the high-speed operation.” They now > Everything is 
be wondering how it’s powered without quickly plan to make an improved version with a narrower- powered using 
causing a tangle of wires. The solution is the use of pitch LED bar. Also on the cards is a 3D POV Display a wireless 
a wireless charging module, one of whose circular using Pico — we can’t wait to see that! charging module 


coils sits on top of the motor, the other in the 
ML  } 


>» The arm spins 
at anything up 
to 960 rpm 









V_ The underside of the spinning 


arm, revealing the reflectance : 
sensor and wireless paola ae coil 1am © 
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Autonomous 
Home Robot 


When Nick Baddorf decided he wanted to make a robot to help around the house, he 
embarked on a very educational journey. Nicola King takes g look at a robotic work-in-progress 





Nick Baddorf 





Nick loves to build 
autonomous robots, 
work on engines, 
and play with his 
dog Penny. 


magpi.cc/ 
nickbrobot 


aking a robot from scratch, with no 
VI instructions, and teaching yourself all 

the necessary programming and various 
systems required is certainly no mean feat. So, let’s 
applaud the tremendous efforts of Nick Baddorf, a 
US-based teenager who has created a unique robot 
completely under his own steam. 

“T have always loved robots,” Nick tells us. 
“Building my own autonomous robot has been a goal 
for me, as long as I can remember. | also wanted to 
make my robot useful. Iam always making things 
but then end up taking them apart the next week 
because they didn’t end up being useful. I challenged 
myself to make this robot useful, and help carry out 
tasks around the house.” 

And so, several years ago, work on the 
Autonomous Home Robot began and it’s fair to 
say that the project has evolved over that time. “It 


A The lidar sensor is mounted on an auto-levelling 
platform to counter the tilt of the robot on the floor 
- this will really come into play when Nick makes 
the robot self-balancing 
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started as a tiny remote-controlled, self-balancing 
robot,” says Nick. “Now it is a big robot that 
navigates around the house!” 


Nuts and bolts 


Nick’s robot basically consists of two sections: 

the base and the head. “The base consists of a 
lidar laser scanner, Raspberry Pi, and Teensy,” he 
reveals. “The lidar scanner, which is mounted on 

a small auto-levelling platform, sends its range 
data to Raspberry Pi. The [latter] is the brain which 
takes in the lidar data and streams it over toa 
master computer for processing. Raspberry Pi also 
sends drive messages to the Teensy, which handles 
motor control.” 

In the head of the robot, Nick has positioned a 
second Raspberry Pi, an Arduino, and a camera. 
“Similarly to the base, Raspberry Pi streams the 
camera feed over to the master computer, and sends 
head movement commands to the Arduino,” he says. 


WV Onthe lower part of the robot is a12V 10A power system for 
the motors. A5V 16A USB power brick is used for the two 
Raspberry Pi boards 


























A Raspberry Pi in the head 

streams the camera feed toa 
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The base contains another Raspberry 
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motors on a four-wheel chassis 








M1 challenged myself to 
make this robot useful, 


and help carry out tasks 








ground the house 


The robot navigates its way around the house 
by using various systems that Nick has installed, 
and it knows where it is in a room by using wheel 
rotations (odometry). Nick elaborates, “This 
odometry is then combined with the laser data to 
make a map. On the map, I can specify a point that 
the robot will drive to, and the robot will make its 
way there, while avoiding obstacles.” 


Robot research 

There was a great deal of technical coding, along 
with languages and systems, to learn before Nick’s 
robot came into being, including Python, C, HTML, 
and OpenCV. The hardest part was to learn Robot 
Operating System (ROS). “It took a lot of reading and 
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The lidar sensor spins 360 
degrees; its data is used by ROS 
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> The project took 
around three years 
to complete 
(part-time) 
studying to set up the robot. Once I was motivated 
enough to put in the time to really learn ROS, 
everything fell into place.” 
Nick is the first to admit that his robot is an 
ongoing project and is continually evolving, but 
the potential is there for it to perhaps carry things 


> Nick won his first 
Raspberry Pi from 
a local group 
that started a 
coding program... 


around the home, act as a robotic companion, > ..when he was ten 
and more. He’s already made many finely tuned years old! 
modifications: “I have added many things to the 

initial design, like tilting laser scanners, tilting > His other projects 


include a ‘mind’- 
controlled 
smart light 


cameras, a rotating head, and even the temporary 
four-wheel drive base,” 
He also has plans for a lot more improvements, 


ao _ 
including new motors, making the robot self > He's working 


balancing, Raspberry Pi 4s, and a big battery so that ona Raspberry 
the robot can completely navigate on its own.” Pi-powered 

Nick is clearly very self-motivated and has input autonomous 
many hours of hard work to get to this point. “I mobile robotic arm! 


asked for feedback recently from my engineer friend 
who encouraged me to focus on getting the core of 
the robot working well and stop adding extraneous 
features. A combination of his help, along with many 
others’, have helped make this robot work!” 
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Haptic navigation 


Satellite navigation may seem ubiquitous, but it doesn't work for everyone, 
Rob Zwetsloot finds out about a project that will make it truly accessible 





Sukriti Chadha 





A product 
manager at Spotify 
who works on 
accessibility and 
also helps develop 
the WCAG group's 
guidelines for 
accessibility online 
and on mobile. 


magpi.cc/sukriti 


ccessibility is an oft overlooked aspect of 
modern technology development. Sukriti 
Chadha’s job is to not overlook it, and she’s 


become an advocate for accessibility in the process. 


This is exemplified by one of her recent projects. 

“For people with hearing impairments, 
walking on a busy street while looking ata 
phone screen can be a challenge, and maybe 
even dangerous,” she explains. In addition, 

“while driving, they might not be able to 
effectively use voice navigation and take their 
eyes off the street to look at directions. For those 
with visual impairments, navigating indoor 
Spaces that are noisy, or experiences such as 
museums, can be less enjoyable because of voice 
navigation interruptions.” 

There are other ways to relay the information, 
though, such as how Sukriti has made use of touch: 
“This open-source solution uses a Raspberry Pi 
Zero W and a mobile phone to relay turn-by-turn 
instructions with haptic feedback, more commonly 
known as vibrations, over an SSH connection with 
the mobile device.” 


M This open-source solution uses ga Raspberry 
P| Zero W and a mobile phone to relay turn- 
by-turn instructions with haptic feedback 


A running thread 

Sukriti tells us that around 466 million people 
worldwide have disabling hearing loss, 34 million 
of whom are children. The WHO believes that this 
number will double in the next 30 years. 

“Having worked in the distracted navigation 
space at a Tel Aviv startup in 2014, I was acutely 
aware of the limitations of voice navigation for 
those with hearing impairments,” she says. 

“My interest in the space was reignited during 


22 | magpicc | Haptic navigation 


a conversation with Pete Cossaboon, who runs 
obstacle races as a blind athlete. I learned that 
he wanted to be more independent in navigating 
the space he is in. Both of these problems could 
potentially be solved with a haptics-based 
solution, and this is the first version of it.” 

Using Raspberry Pi made sense in this context 
due to its low price and small size, and Sukriti found 
it easier to work with too. “For me as a developer, 








A Raspberry Pi Zero W is 
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A You can rest it on your person 
while driving to get directions 






The sensors vibrate to 
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programming on Raspberry Pi is intuitive, 
especially since I was looking for an interface 
between a mobile phone and a physical device.” ™ 


Touch and go 

The system currently works using Mapbox, a 
third-party mapping and navigation service, 
which provides the directions that are then 
translated to vibrations on the device. It can be 
extended to other frameworks with an API that 
allows for HTTP requests to be sent to Raspberry 
Pi, such as iOS and mobile web. 

“Tt works really well in terms of navigation 
... for people with hearing impairments,” 
Sukriti reveals. “I can see its applications in VR 
navigation as well. The solution would be even 
more useful for visually impaired users with 
proximity sensors to help avoid obstacles, in 
addition to navigation outdoors.” 

Work is ongoing with the project, with Sukriti 
wanting to add more haptic sensors for different 
navigation commands, proximity sensors, PWM 
output for varying intensity, and more. 

“T have tested the prototype with a couple 
of people, and the feedback has been really 
positive,” she says. “I have personally been using 
it on runs, SO my music is not interrupted if I go 
on unfamiliar paths.” 


The basic electronics are 
quite simple 


Haptic navigation 


> The entire setup 








costs $20 


> Sukriti has used it 


attached to a leg 
while driving... 


> .and in asmall 


messenger bag for 
on foot 


> The vibrations are 


provided by two 
1.5V motors 


> Itcan be powered 


by a smartphone 
that has USB-C 
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CamChess is “100% Python”. It uses 
OpenCV, NumPy, and python-chess 


CamChess 





The setup uses a Raspberry Pi Zero 
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could also be used 


chessboard with plastic pieces. 
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Chess Is in vogue, prompting a proficient player to finally create a version 
based on a club-standard playing board. Rosie Hattersley learns how 





Geoff 
Fergusson 





Retired computing 
consultant 
Geoff's last major 
professional 
assignment 

was designing 

a battlefield 
logistics system, 
playing neatly to 
his chess-honed 
tactical strengths. 


magpi.cc/ 
camchess 
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eoff Fergusson is the former captain of 
(5 a county chess team, so he knew exactly 

what to build with his Raspberry Pi. “It was 
natural that I should build a chess project,” explains 
Geoff. “The Queen’s Gambit TV series has spurred an 
interest in the game, so the timing is right.” 

Playing against an on-screen computer opponent 

just isn’t the same, says Geoff. “It loses the social 
aspect.” Furthermore, it takes time to adapt from 
on-screen diagrams to playing with a physical 
board and pieces — something he imagines more 
people doing now that the TV show has given chess 
a moment in the spotlight. “The ideal practice is to 
train with the same board and pieces as you would 
use at the local club,” he says, but it’s prohibitively 
expensive for schools and many clubs, which is 
where his CamChess project fits in. “I wanted 
to build a system that would work with standard 
plastic pieces on a standard vinyl board,” and also 
record the moves. 


A canny move 
CamChess combines the best elements of an 
electronic board with the ability to record moves, but 


costs only around £50 (S70) excluding Raspberry Pi 4. 


After retiring 20 years ago from his jobas a 
consultant for large-scale computing systems, Geoff 
has racked upt experience of building small-scale 
projects. Despite a 30-year break from it, he can still 
write code. “Python was a bit of a culture shock,” he 
reveals, “but I soon adapted.” Geoff made full use of 
standard Python modules, along with OpenCV and 
NumPy for image processing, and Stockfish as the 
chess engine. 

A Raspberry Pi Zero with an attached ZeroCam 
worked well for capturing images of the chess board. 
Mounting the ZeroCam on a door-frame, using 
some sticky tape high above the centre of the chess 
board, helped minimise lens distortion. Raspberry 
Pi Zero takes pictures on command and sends them 
back to another computer for analysis. Geoff used a 
Raspberry Pi 4 to do this, but says any “non-antique”’ 
Linux, Windows, or Mac computer would work. 


Match ready 

Due to congested WiFi channels where he lives, he 
opted for Ethernet to connect Raspberry Pi 4 and 
Raspberry Pi Zero and send images using the USB 
cable that also powers the latter. These images 
tell the computer the latest chess move that has 








| wanted to build g system 
that would work with 
Standard plastic pieces 


been made, which python-chess then replicates 
on-screen. Having experimented with the image 
comparison method used by Realtime-OpenCV- 
Chess, Geoff thrashed out a method that determines 
whether each chess square is empty or occupied, 
and whether it’s a white piece or a black piece. 

It was a challenge to get the board to configure 
itself automatically, but Geoff eventually worked 
out how to do so using standard threshold 
optimisation techniques. CamChess now only needs 
to be shown the start position, and works out its 
internal settings from there. CamChess’s difficulty 
level can be set to engage the hobbyist player and 
they can make moves for both sides until they reach 
a position that is of interest to them. 

While he’s largely happy with the existing build, 
Geoff hopes others will make their own versions 
of CamChess and let him know how they get on. 

We did ask him about his own next move, but he’s 
keeping mum. 





Engine Move: 4...d5 
| Next>> | Takeback Engine | Level | Blip | 


The ZeroCam picks up moves on the 
board and displays them on screen 


MagPi 


A Raspberry Pi 
Zero with ZeroCcam 
is fixed to the 
ceiling above 







Geoff advises 
wannabe makers 
seek out similar 
projects to theirs 


Emulating 
others’ code and 
methodology 
provides a good 
head start 


Geoff had admired 
Vatsal Parsaniya’s 
Realtime-OpenCv- 
Chess (magpi.cc/ 
opencvchess) 


Which deduces 
chess moves by 
subtracting one 
image from another 


CamChess was 

also inspired by the 
Raspberry Turk chess 
robot (magpi.cc/ 
raspberryturk) 
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Automated Camera-Based 
Drone Landing System 


When Dr Chinthaka Premachandra and his team looked to gutonomously land g drone using 
our favourite computer, it was certainly no pie in the sky ideg, as David Crookes discovers 





Dr Chinthaka 
Premachandra 





Chinthaka is an 
Associate Professor 
in the Department 
of Electronic 
Engineering at the 
Graduate School of 
Engineering in the 
Shibaura Institute 
of Technology. 


magpi.cc/ 
dronelander 


WV The drone looks for the 
landing pad by monitoring 
captured images before 


moving to the landing spot, 


hovering, and determining 
that it’s safe to land 


ravity dictates that what goes up must 
(5 eventually come down but, when flying 

a drone, it helps if the landing is as 
smooth as possible. 

That’s doubly true for an unmanned drone since 
a crash will not only render it unusable, it could 
also potentially put lives at risk. 

As such, researchers have been looking at 
ways to ensure autonomous aerial vehicles can 
identify and make use of a safe landing spot. 
“This is especially important when the drones 
are operating around disaster sites,” says Dr 
Chinthaka Premachandra from the Shibaura 
Institute of Technology in Japan. 

To do this, Chinthaka has been leading a team 
in using a Standard radio-controlled quadrocopter 
drone fitted with a Raspberry Pi 3B+ and a mini 
camera. They’ve worked on an automatic landing 
system, allowing the drone to be brought down to 
the ground without mishap. 

“Automatic landing is a kind of automatic flight 
towards a specific landing spot and to achieve this 
with a drone it must find the landing spot itself,” 
Chinthaka explains. “I believe that landing spots 
can be recognised by processing the images from 
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an on-drone camera, but this image processing 
needs to be implemented in real-time, generally 
less than 15 milliseconds.” 


Be snappy 

It’s this need for fast on-board processing that led 
Chinthaka to consider using Raspberry Pi. “The 
idea is that flight control is conducted as soon as 
the images are processed, so we not only needed 

a good, lightweight camera but a lightweight on- 
drone computer too,” he reveals. “Raspberry Pi 
3B+ is obviously lightweight and it can be easily 
implemented within a drone. Raspberry Pi 4 can be 
used for this too.” 

The camera was chosen because it has a wide 
angle. “It’s wider than the other cameras that are 
compatible with Raspberry Pi, so it can capture 
a large area and this capturing ability makes it 
easy to identify a landing spot,” says Chinthaka. 
A depth camera was also important. “During the 
drone landing, the ground object information can 
be easily recognised with a depth camera rather 
than a 2D camera.” 

For optimal results, the camera lens is kept 
horizontal, even when the drone body is not in 





A The wide-angle camera can 
capture a large area to help 
identify a landing spot 
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this position during the flight. “If the lens was 
not always horizontal, then it would be difficult to 
smoothly capture the landing spot during flight 
because of the shaking of the drone,” Chinthaka 
explains. “We made our own lightweight 

gimbal to keep the camera lens horizontal but a 
commercially available gimbal may also be used 
for this task.” 


™ Some parts of the 
software include OpenCV 
library functions @ 


H marks the spot 

The idea is that the drone looks out for an H-shaped 
symbol placed on the ground at the landing 
location. Using software created by the team, the 
image is processed and converted into physical 
co-ordinates to generate a horizontal feedback. 

“Some parts of the software include OpenCV 
library functions,” says Chinthaka. “We also wrote 
software for the landing process, but developing the 
necessary algorithms to detect the landing spot in 
real-time was the greatest challenge.” 

Even so, the researchers were able to get the 
image processing time down to three milliseconds. 
This allows the drone to quickly fly over to the 
landing spot, hover over it, and land vertically, all 
controlled by Raspberry Pi. “It’s been a big success 
and we expect it will have a wide number of future 
uses,” Chinthaka concludes. W] 
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controlled manually Sarees 
Be careful: The spinning 
blades on a drone can 
cause injuries. Make sure 
you fly your drone safely 
and legally. 
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drone is fitted with a depth camera 





> Raspberry Pi 
controls the drone's 
safe landing 


>» The drone isa 
standard radio 
control model 


> It lands at the 
centre of a 


landing pad 


> The height control 
operates at 20HZ 


> Computing time 


is down to three 
milliseconds 


yi "* 


ban 






A Agimbal was built by combining two servos with 
3D-printed parts and this ensures the camera, which 
sits at the very bottom of the setup, is stabilised 
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The Smart 
Crust-Cutting Robot 


This innovative invention by Andrew DeGonge Is arguably the best thing 








Andrew 
DeGonge 


Andrew is a 
computer engineer 
in the med-device 
industry who has a 
passion for building 
unique and 
over-engineered 
robotics projects. 
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Warning! 
Sharp edges 


Be very careful when 
using knives and never 
work on a device such 
as this with the power 

switched on. 


since sliced bread, as David Crookes discovers 


debate to get people talking. Do you cut 

sandwiches into rectangles or triangles? 
Are you calling it a roll, bap, barm, or muffine And 
do you eat your crusts — thereby ‘guaranteeing’ 
your hair will grow curly - or slice them off and 
throw them away? For Andrew DeGonge, the 
latter question has a clear-cut answer: crusts are 
to be chopped. Indeed, he’s so determined that 
the sides of bread are banished, he’s used his loaf 
and created an automatic guillotine-like device to 
do the hard work for him. “Crust in general isn’t 
my main problem. Cheap bagged bread is,” he 
tells The MagPi. “It’s all so mushy and the crust 
is even more of a burnt, soggy mush. So, like any 
reasonable adult, I prefer bagged bread without it 
to make it a bit more tolerable, although I do love 
the crust on a good sourdough or Italian loaf.” 


T here’s nothing quite like a good bread 


No crumby thought 

The idea for a crust-cutter rolled into Andrew’s 
head when he was considering building a robot 
with computer vision. “I wanted it to be original 
so I thought to myself, ‘what’s a problem many 
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people have that doesn’t have an automated 
solution®’ I realised there was no way to 
automatically cut the crust off sandwiches so 
decided to create one, just because I can.” 

Andrew spent ten hours creating a CAD 
drawing of the project, ensuring enough room 
for the necessary motors and knife. “I went with 
stepper motors for the motion control and used 
V-slot extrusions and wheeled gantries for linear 
motion,” he explains. 

He also built a custom four-axis control board 
(“the OSR, which controls all of the stepper 
motors”) and he used a Raspberry Pi 4 paired with 
a Camera Module V2. “Raspberry Pi is the easiest 
and cheapest way I know to integrate computer 
vision into my projects,” he says. 

As such, with the components sitting within 
a 3D-printed frame, Andrew envisaged placing 
a sandwich on a rotating cutting board before 
having the camera take images for analysis using 
OpenCV. “I spent 30 to 40 hours on the code, which 
included all the OSR, computer vision, and Python 
segments,” he reveals. It was time to get chopping. 


Sticking the knife in 

By comparing the current image frame to previous 
ones, the device determines the shape and size of 
the bread. “I then feed the rotation of the rectangle 
to the stepper controlling the turntable cutting 
area to align the sandwich with my knife,” Andrew 
says. “Next, the knife moves horizontally in the 
X-axis to a position that is a small offset in from 
the edge of the bread, and finally the Z-stage 
comes down and makes a cut. Then it’s a matter of 


> There are delays in key 
points of the final routines, 
and cutting board rotations 
are performed before a 
chop to give advanced 
warning before cutting 


Pi or Ve ~— 
ee g . . ae 7 | doing three more rotations and three more cuts to 
) a : remove the rest of the crust.” 
The main problem was figuring how to convert 
the camera’s pixel measurements into real-world 
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Although a Raspberry Pi 4 is used for 
| the project, Andrew says a Raspberry 
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A Andrew's own four-axis control board (dubbed the OSR control 
board) communicates with Raspberry Pi via USB and controls 
all the stepper motors 
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M |t's now a seriously capable 
bot that cuts bread very 
cleanly and accurately @ 





>» The device uses an 
aluminium frame 


> It also Involves 
measurements. “I ended up uniformly converting 3D-printed parts 
the measurements because cutting food doesn’t 
need to have sub-millimetre accuracy,” he says. “I 
ran into some motor control issues which ended up 
being bugs in my stepper control loops, but it all 
works pretty well.” 

Now Andrew doesn’t worry about crusts, 
especially now he’s using a sharper knife. “People 
criticised the bot for not cutting well enough, so I 
redesigned the gantry to support a sharper knife 
while using a pivoting knife mechanism and adding 
a food-holding, spring-loaded platform. It’s now 
a seriously capable bot that cuts bread very cleanly 


> Belts and stepper 
motors move the 
cutting board 


> Computer vision 
figures the position 
of the cuts 


> It cost a lot of 
dough: around $200 





j ; A And cut.. the knife plunges down towards the bread, slicing 
and accurately. It’s cool, if not a little scary.” Hl the crusts clean off 
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Giant Hornet 
Detector 


Massive marguding insects threaten native bee populations, so one techie 
aplarist used Raspberry Pi to sniff them out. Rosie Hattersley hears how 








4. 





Sean Cusack 


Bee-keeper, 
Microsoft engineer, 
and Raspberry Pi 
admirer Sean enjoys 
finding “elegant 
technical solutions” 
for monitoring 

the health of 

his beehives. 


magpi.cc/ 
beetrackergit 


urder hornets have become the stuff of 
Vi tabloid hyperbole and alarming YouTube 

video clips, but Asian giant hornets (as 
they’re more properly termed) aren’t all that 
common. However, they’ve been making inroads 
in the US state of Washington where maker and 
long-term apiarist Sean Cusack lives. Keen to avoid 
seeing local bees’ nests destroyed, he set about 
creating the Murder Hornet Detector, a citizen 
science project that identifies the invasive species 
and demonstrates a rather good use of Raspberry Pi. 

Sean has been keeping bees for around seven 

years and began developing a small photo booth 
— the HoneyBee Booth - that would use artificial 
intelligence to detect and count Varroa mites, 
and notify him of the findings. He adapted it to 
detect other species on hearing about the murder 
hornets’ arrival. 


A Anas-yet-unresolved issue is how to photograph 
booth visitors, such as this earwig, from the 
bottom as well as the top to aid identification 
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Geolocation data of any affected hives is sent 
to a Microsoft Azure IoT Central dashboard. 
Washington’s Department of Agriculture can use 
this in their efforts to eradicate the invasive species. 
“Using Raspberry Pi3, Arducam [camera], small 
motion sensor, and 3D-printable case, I’m able to 
classify an image in about two seconds,” says Sean. 
However, keen to make this an easily and cheaply 
replicable project, he suggests a S5 Raspberry Pi 
Zero will work almost as well, with the caveat that 
identification takes closer to a minute. 

Sharing the resulting images poses a problem, 
since many beehives are remotely located, but 
Sean is hoping LoRaWAN (Long Range Wide Area 
Network) will help. LoRaWAN is designed to work 
with low-power devices over vast areas and will 
work well in locations not covered by 3G or wireless 
LAN. “All the image classification takes place on 
Raspberry Pi, leaving only the need to transmit 
telemetry data, which should fit nicely within 
packet size limitations that exist with LoORaWAN.” 


Track and trace 
Sean is keen to ensure others can replicate his 
project, envisaging “a non-tech savvy bee-keeper” 
putting one together and watching for Asian giant 
hornets. Cost, open-source code, and a simple 
build were therefore priorities. “I love the idea of a 
community contributing to a large pool of images 
that can be used to further train and improve the 
learning models,” he says. It also means Raspberry Pi 
Zero can be used, Keeping all-important costs low. 
He sketched and 3D-printed his own basic, but 
weatherproof, case as the camera booth and to 
house Raspberry Pi. There’s a hole on the top for 
the LED, while the camera and wires for the motion 
sensor were inserted via the booth door and attached 
at the end. Sean enabled SSH and I2C using the 
command prompt (see the setup instructions at 
magpi.cc/beetrackergit) so Raspberry Pi can be 
accessed remotely. A funnel added at the end helps 
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™ Murder hornets have 
become the stuff of tabloid 
hyperbole and alarming 
YouTube video clips @ 





ensure insects are hustled into the booth to be 
photographed. Getting the camera focus right and 
clear images of booth visitors was time-consuming 
but, as Sean’s enthusiasm shows, the results have 
proved rewarding. 


Exciting sightings 

Sean is excited about the possibilities of the 

project based around a camera, motion sensor, 

and a learning model. “Maybe you want to spot an 
incoming locust migration, get up-close pictures of 
a very rare insect species, [or] spot elephants on a 
train track and alert the conductor or train station 
to stop°” he enthuses. “I can’t wait to see what de ee wacieaee eee 
people come up with!” weather protection cover 
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> Sean needed 
an Asian giant 
hornet to train 
his detector... 


> ..So he got 
Washington's 
Department of 
Agriculture to send 
him one! 


> Friends ata 
hackathon helped 
Sean refine 
the HoneyBee 
Booth design 


> Overcoming 
motion blur was a 
particular challenge 


> Sean's setup now 
works really 
well, “even on 
blurry images’ 
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MagPi | FEATURE 


HOME 


Jr [Ae 


FUTURE 


Automate your home 
with Raspberry P1 








By PJ Evans 


e love home improvement here at 
W The MagPi, and if there’s any excuse to 

fit a new piece of kit around the house 
we’ ll jump at it. Raspberry Pi is the perfect tool 
for smart home setups. It is easy to program, 
small and unobtrusive, and the wireless LAN 
networking and GPIO pins make it perfect for 
chatting to, and controlling, smart devices around 
the house. 

In this feature we will look at how to install 
smart lights, control central heating, pump 
internet music throughout the home, keep tabs 
on the critters in your garden with smart cameras, 
cook with robotics, and much more. 

It’s time to pay a visit to the home of the future. 
So let’s get building. 
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Warning! 
Electrical Safety 
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GETTING START CU WIA 
HOME AUTOMATION 


Put a Raspberry Pi computer at the heart of your home 





tarting out in home automation can be the conductor. It supports hundreds of different 
= a little overwhelming. There are many devices and allows you to control, group, and 
competing standards, some devices are create rule sets that govern their behaviour. 
harder to use than others, and there’s the issue of Best of all, it has a dedicated Raspberry Pi image 
locked-down services demanding subscriptions available that makes setting it up and managing 
and access to your data. The good news is there’s a the server very straightforward. Alternatives 
massive community dedicated to open-source and include OpenHAB and cloud-based services 
self-hosted solutions where you’re in control. like IFTTT. Check out our three-part guide to 
We would struggle to find a better Home Assistant in The MagPi issues 99, 100, and 
place to start than with Home Assistant 101 (magpi.cc/issues). 
(magpi.cc/homeassistant). If you view all the 
V Home Assistant is various switches and sensors that make up your aa) Th e re's gmdss ive 
eae home’s Internet of Things (IoT) as instruments | | 
smart devices in an orchestra, then Home Assistant (HA) is community dedicated to 


open-source and selt- 
hosted solutions @ 


Once you have your ‘conductor’ in place, 
it’s time to add the musicians. In the next few 
pages we’re showcasing projects that have been 
carefully selected to make the most of your home 
without compromising your privacy. 





A Home Assistant can be used on mobiles, touchscreens, or 
your desktop - from anywhere in the world 
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LIVEN UP YUUR 
LIVING ROOM 


Whether it's music, TV or game time, tech can help 


v Install smart lighting 

Most HA projects start with lighting. Being able to 
switch lights on throughout the house, wherever 
you are, or have them react to different sensors 

or events is a great way to get started in this field. 
There are a lot of options and the prices have 
plummeted. Check out Ikea’s Tradfri range, or the 
popular Philips Hue system. 





v Build a home cinema 

How about the ability to convert your living room 
into a cinema at the click of a button? Logitech’s 
Harmony Hub (magpi.cc/harmonyhub) allows 
you to control your TV, amp, and game consoles 
from your phone or Home Assistant. You can 
create complex scripts and also set lighting or 
lower blinds. Popcorn optional. 








a Set up a smart sound system 

If you’re after some sounds, check out our recent 
tutorials on building the ultimate music server 
using Raspberry Pi and Mopidy. Create your own 
Sonos-rivalling system and have synced music 
throughout the home. A Raspberry Pi Zero with an 
inexpensive DAC (digital-to-analogue converter) 
HAT will give you excellent audio reproduction for 
a fraction of the commercial price. See issues 96, 
97, and 98 (magpi.cc/issues). 


Control your central heating 

Need to be cosy? Need to control exactly how 

cosy you are°® Many solutions exist for remote 
control of central heating. We particularly like the 
motorised thermostats (magpi.cc/smartradiator) 
that can be quickly 

added to radiators 

as these give you . (= 
precise control over ; 

every room and HA 
can use individual 
temperature sensors 
to get every room 
just right. 
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Build a 
magic mirror 


A magic mirror 
places a screen 
behind a semi- 
transparent sheet. 
Once framed, 

it gives the 
impression of text 
floating in the air 
that can display 
your calendar, 
the weather, or 


| anything else. To 


find out how to 
make one, pick 
up a copy of The 
MagPi issue 90 
(magpi.cc/9g0). 
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AUIUMAIc YUURK KITCHEN 


Improve your kitchen gadgets with even more gadgets 


> Install 

smart meters 
The kitchen is the 
heart of the home, so 
it pays to keep an eye 
on how much blood 
it’s pumping. As 
Smart meters roll out, 
it’s good to know that 
many models such as 
Honeywell’s AS302P 
advertise their usage 
to supplied displays. With a bit of help, these 
transmissions can be captured by HA so you can 
create your own dashboards or set alarms when 
the cooker gets too greedy. Take a look at this 
tutorial by Erik Schrama (magpi.cc/smartmeter). 





v Wire up a coffee machine 
If you really want that fresh coffee in the morning aa) A lO g | cq | fi rst ste 0 for 


to be just right, how about automating your 


coffee machine? If your machine can start when th Q h ome gutomat | on 
power is applied, then a simple WiFi power 

switch will suffice. There are some ‘smart’ coffee fd nis monitorin G of 
machines available such as Smarter Coffee ; 
(magpi.cc/smartercoffee), but another option is th e environment ” 

to add a button-presser such as MicroBot Push 

(magpi.cc/microbot) that’s controllable with HA. v Discover sous-vide 


This amazing technique cooks plastic-wrapped 
food in a water bath using precise temperatures. 
The result is tender and flavoursome meals that 









Get smart about safety cook over hours not minutes. Sous-vides are 
After lighting, a logical first step for the home typically expensive, but you can build your own 
automation fan is monitoring of the environment. and monitor it using HA, such as this project 
Smart smoke alarms and carbon monoxide (magpi.cc/sousvide). As ever, always be careful 
detectors are available, but you may be mixing electricity and water. 
- interested in making open-source versions 
& so you can trigger alerts when things 





don’t seem right. The Pi Hut sells an 
MQ-135 Gas Sensor (magpi.cc/mq135) 
which is great for experimenting with 
home-built smoke detectors. Please 
note that no DIY smart device is ever any 
replacement for a proper certified smoke 


> . alarm, such as those made by FireAngel 
(fireangel.co.uk). 
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UREAIE A CLUUL 
KIDS ROOM 


Use tech to brighten up your bedroom and keep unwanteds away 


v Set up a sibling alarm 

Brothers! Sisters! Boo! If your sibling is driving 
you up the wall by messing with your stuff, then 
catch them in the act. Using a Raspberry Pi HQ 
Camera and a cheap magnetic door sensor, you 
can take a photo or record video whenever the 
door opens, then send it straight to your phone. 
Busted! Take a look at this Room Guard project: 
magpi.cc/roomguardproject. 





v Fit some fun lighting 

If you really want to make an impression on your 
friends, get some LED strips and power them with 
a Raspberry Pi. You can start with single-colour 
5050-type LED strips or move up to individually 
controllable NeoPixel sets (magpi.cc/neopixels). 
A project like this can just build and build; how 
about adding a microphone to create dancing 
lights°e The Pi Hut has a great NeoPixels tutorial 
(magpi.cc/usingneopixels). 








> Fit a dinner 
klaxon 
A really popular project 
from The MagPi issue 73 
(magpi.cc/73), the 
teenage klaxon is the 
ultimate solution to 
yelling up the stairs 
in frustration ata 
headphone-clamped 
offspring. Simply use the 
web interface on your 
phone to set the candle 
light to green, amber, or 
‘right, now you’ re really 
in trouble’. 








Back issues 


Don't miss out 

on our earlier 
issues, See our 
At Home with the 
Internet of Things 
feature in The 
MagPi issue 93 


(magpi.cc/93) 
and Home 
v Listen to internet radio Halloween Hacks 
No kid’s sanctuary is complete without some (magpi.cc/98). 
sounds. Why not add to your home audio system | en, 
(see ‘Liven up your living room’, page 37) with Pa obcrvel 


another device or build an internet radio, capable 
of reaching thousands of stations across the 
elobe. We really like Pimoroni’s Pirate Radio 
(magpi.cc/pirateradio) as a great starter kit. 


tutorial series can 
be found in issues 
99, 100, and 101 
(magpi.cc/issues). 
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HOME OFFICE 


Don't work hard at home, work smart at home 


> Build a do-not- 
disturb sign for 
your office 





addressed one of the burning issues of the 

day: how do I let my family know I’m ona 
Zoom call? We invented a ‘digital do-not-disturb 
sign’ that can be remotely controlled by some 
buttons or an event detected by Home Assistant. 
Display any message you want right outside your 
door and avoid those moments that could send 
you viral on social media. 


M Display any message you want right 
outside your door @ 


n The MagPi issue 103 (magpi.cc/103) we 


> This miniature railway 
sign can make sure 
you are on time 
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If you’re working at home and have your 
own working space, particles and gases (now, 
now) can build up without proper ventilation. 
Consider adding a Pimoroni Enviro+ to your 
arsenal (magpi.cc/enviroplus). This HAT with 
optional add-on particle sensor monitors dust, 
temperature, and other concerns, sending the 
data straight into Home Assistant. 

Home automation isn’t just about switching 
lights on and off. There’s a wealth of information 
provided free-of-charge from the internet that 
you can use to affect your environment. A great 
example is the data that powers all the railway 
station displays in the UK. This is freely available 
and this great project by Chris Crocker-White 
(magpi.cc/trainoled) allows you to make your own 
home display. 

Our newest member of the Raspberry Pi 
family, Pico, can act as a keyboard over USB. 
Pairing one with Pimoroni’s RGB Keypad Base 
(magpi.cc/rgbkeypad) creates an inexpensive 
macro keyboard. Create short cuts for your 
common operations and program them into your 
Pico to speed up your day. No more fighting with 
the mouse to reach ‘Leave Meeting’. 


JAKE YOUR oMARI 
TOYS OUTSIDE 


Track wildlife, tend to the flowers, and keep 
an eye on the world with these projects 


£§PVOutput 
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4 Install solar panels 

If you’ve got solar panels, chances are the inverter 
(the device that converts DC electricity to mains AC) 
is producing vast amounts of information that HA 
and other services such as PVOutput (pvoutput.org) 
can consume. Some have USB connectors, but many 
more have Bluetooth connections, making it easy 
and safe to link a Raspberry Pi to keep track of all 
that lovely sunlight powering your house. 





4 Plant monitoring 

A smart garden is a better garden. Keep track 

of moisture levels using sensors coupled with 
devices like the IoT Cricket (reviewed this issue) 
to relay our soil condition to HA. You can then 
create rules to alert you when your favourite 
plants need a drink. More advanced tinkerers can 
add irrigation systems controlled by HA. Check 
out Pimoroni’s Grow range (magpi.cc/grow). 


v Ring the smart doorbell 


Another stalwart of the home automation scene, 
smart doorbells are becoming commonplace on 
our roads. Systems like Ring’s video doorbell 
(ring.com) provide video to your smartphone and 
even the ability to talk with the person at your 
door from anywhere in the world. If you would 
prefer a more DIY approach, check out our smart 


door feature (magpi.cc/smartdoor). 





Watch the wildlife 


A Raspberry Pi wildlife camera (such as 
Naturebytes’, naturebytes.org) is just the 


thing for keeping an eye on various visitors to 
your garden or window box. This can be a great 
evolving project. Start with a camera trained on 
your garden (consider a Raspberry Pi NoIR camera 


for night vision), then 
add motion triggering 
and even machine 
learning to identify 
different birds. Take 
a look at this Watch 
Wildlife tutorial that 
first appeared in 
HackSpace magazine 
issue 33: Magpi.cc/ 
watchwildlife. 
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The MagPi 70 


We featured a 
range of smart 
home hacks in 
The MagPi issue 
70 (magpi.cc/70). 





Power sockets 
Control cheap 
power sockets 
using radio 
commands with 
the Energenie 
HAT. Full house 
coverage and 
simple to set up. 


Doors and 
doorbells 
Creating internet- 
connected door 
sensors and 
doorbells can 

be surprisingly 
simple and 
inexpensive. Get 
a heads-up when 
the door opens 
behind you. 


Smart fish tank 
When an 
aquarium heater’s 
thermistor fails, 

it tends to heat 
the tank too 
much. Get an 
alert with this 
straightforward 
monitoring 
project. 
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K.G., 
Orphanides 





K.G. is a writer, 
maker of 

odd games, 

and software 
preservation 
enthusiast. Their 
family fully 
supports the idea of 
an arcade machine 
in the living room. 


@KGOrphanides 


Build an arcade machine: 


Get the parts 


If you've ever wanted to build your own arcade machine, here's your guide, 
This month: the parts you'll need, how to choose them, and where to buy them 


ver the coming months, we’ll go 
t through the process of sourcing, 

building, connecting, and installing a 
Raspberry Pi-based arcade cabinet. 

While you can restore and convert a former 
JAMMA cabinet for use with Raspberry Pi, 
or build a cab entirely from scratch, we’ll be 
taking the flat-pack route. This lets you build 
the cabinet of your dreams relatively easily, 
somewhat cheaply, and without recourse to 
full-on home woodworking. 

This tutorial series will use an LCD screen 
due to the inconvenience of sourcing and 
potential issues with installing a CRT model, 
which carries the risk of a dangerous electric 
shock if not correctly discharged. 


Choose your cabinet style 

If you’re after a classic upright one- or 
two-player cabinet, then you’!l want either an all- 
in-one model or a ‘bartop’ cabinet with a pedestal 
or Stand. Bartop cabinets can also be bought 
without the optional stand and placed on a table. 

Flat ‘cocktail’ or ‘coffee table’ style cabinets 
are available in models for between one and four 
seated players and often use a vertically oriented 
screen, which can be split by software into two 
horizontal views for multiplayer games. 

Other models include seated upright cabinets 
(often designed to take very large screens), 
angular tabletop models, and mini-bartops with 
10-inch displays for those short on space. 
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Big screen glamour? 

The size of your screen dictates the size of your 
cabinet, and vice versa. Before you start shopping, 
work out where you want the cabinet to live, and take 
height, width, and depth measurements. 

If you’re working with a 19-inch monitor, 
you’ ll likely get a bartop cab that’s a little under 
50cm wide. This is the most practical choice 
if available space is limited. A 22-inch screen 
translates to a cabinet of a little under 60cm, and 
a 24- or 25-inch screen means a cabinet width 
of a bit under 65cm. You’re generally fine fitting 
a smaller screen in a larger cabinet, but the end 
result won’t look quite so polished. 

Check the internal measurements of the cabinet 
against those of the monitor, including its bezel. 
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A good fit Finish and decoration 
Depending on the era of games you want Regardless of the materials used, you’ ll 
to play, a large 1920x1080 widescreen display probably want some plastic edging strip. This 
may not be the most authentic choice, but it is plastic trim helps to protect the edges of your 
the most flexible, and modern emulators handle cabinet, makes it easier to clean, and looks a lot 
HD displays well. more professional than exposed MDF edges. 
Most cabinets have a VESA mount, usually in the Two types are popular. T-Molding is more 
form of a monitor support bar drilled for 75x75 and secure but requires a slot to be cut for it to clip You can get kits 
100X100 mount points. Make sure your monitor into - some DIY kits have ready-cut slots for this containing all the 
has mounting points that match. purpose, but budget models frequently do not. ee 
Finally, ensure that your monitor will work with U-Molding just clips over the edge. Cabinet rae eal lise ire Ao 
Raspberry Pi: anything with a standard HDMI input makers will usually tell you how much moulding hole sizes match 


should be fine, but older DVI and VGA displays 
require inconvenient adapter arrangements. 


Materials 

Self-assembly cabinets are usually made in 
MDF, but laminate, melamine, and veneer finishes 
are also widely available. 

MDF swells badly if exposed to water, so if you’re 
going to have drinks anywhere near your cabinet, 
a water-resistant finish is strongly recommended. 
If you buy an untreated MDF kit, apply and sand 
down between multiple coats of an MDF-specific 
solvent-based primer, then paint it to your heart’s 
content, ideally with oil-based paint. 

18mm MDF is common, but you’! find cabinets 
in anything down to 10mm for budget models. 
18mm or thicker construction materials may 
require a longer shaft or extender for your joystick. 
If in doubt, talk to the kit’s supplier. 
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A. Avariety of compact 
bus- and mains- 
powered amp and 
speaker kits are 
available: this one 
takes power from the 
USB port and audio 
from the 3.4mm port 


their kit will need and can usually supply the 
required quantity and type of edging. 

Many arcade cabinet suppliers also sell a range 
of decorative and protective graphical vinyl sticker 
wraps. These should be applied with care to an 
appropriately finished surface (check with the 
sticker manufacturer for any finish requirements). 


A giant screen protector 

To protect your screen and create a 
flush finish, you can — and should — opt for an 
acrylic (polymethyl methacrylate, also known 
as plexiglass) screen protector. Again, this is 
something most self-assembly kits are designed 
to take and the majority of retailers will happily 
sell you one as either a standard part of the kit 
or an optional extra. Make sure you do opt in, as 
cutting your own plexiglass to precise dimensions 
can be a pain. Toughened glass and UV-resistant 
polycarbonate can also be used. You may need to 
add some standoffs to stop front monitor buttons 
being pressed by the screen protector. 


07 The marquee club 
Also included in kits as a matter of routine 
is a Strip of acrylic for your cabinet’s top marquee. 
You’ll probably want to get a backlight-ready 
vinyl marquee (available from print shops, arcade 
suppliers, and on Etsy) to stick to this, but you 
could also decorate your own. 
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Sample shopping list 


Here is an illustrative price list. The prices include VAT 
but not shipping or additional costs. 






24-inch LCD monitor £125.00 
Bartop cabinet £170.00 
Bartop stand £100.00 
10m T-Molding £25.00 
— bas 
Rise USB joystick + Foran 
Amp, speaker & cover kit £25.00 
Amp power supply £12.00 
Printed marquee £6.00 
LED strip lighting £15.00 
pe ss adapter eae 
5-way plug bar £15.00 
TOTAL £603.00 


While you’re at it, you may wish to get acrylic 
or metal panels to surround your buttons and 
joystick. These can be decorated, and protect your 
cabinet’s surface, as well as providing a smoother 
feel. Button layouts tend to be standard, but these 
should ideally be bought from the same supplier as 
your kit for the best fit. 


Raid the button tin 


We’ ll be building a cabinet with an eight- 
way joystick and six 30mm buttons, plus Start 
and Select buttons, for each player. A variety of 
alternative sizes and brands are available, with 
Sanwa perhaps being the most recognisable. 

You can order a cabinet with holes for extra side 
buttons if you’re into digital pinball. 

An easy cross-platform connection solution is a 
USB arcade encoder. Models by Zero Delay and Xin- 
Mo are popular, but the I-PAC 2 keyboard encoder 
has slightly lower latency. 





A lf you want to use USB, the Ultimarc I-PAC 2 encoder is a 
popular choice that'll work with most computers. Check out 
magpi.cc/ultimarcgit for advanced configuration 


Pick a driver 

You can connect controls to 
Raspberry Pi’s GPIO, using either the Adafruit 
Retrogame (magpi.cc/adaretrogame) or 
mk_arcade_joystick_rpi (magpi.cc/mkjoystick) 
drivers — we’ll be using the latter. 

Arcade joysticks generally use a five-pin JST 
connector, while non-illuminated buttons each have 
a pair of quick-connect spade connector fittings, one 
of which must go to ground. Spade to DuPont GPIO 
cables are uncommon, but can be bought either 


individually or as part of a kit from specialist retailers 


such as SmallCab. Illuminated button kits are 
available with an extra external PSU. 


™ LED strip lighting Is 
q popular choice for 
marquee panels 
The sound of success 
It’s a good idea to order your cabinet with a 


couple of pre-drilled speaker holes and covers to go 
over them. The most common option for audio is an 


externally powered stereo amp, connected to Raspberry 


Pi’s 3.5mm port, and 10cm/4-inch speakers, but USB- 
powered kits are also available. If you have one lying 
around, you could also consider mounting a compact 
USB sound bar behind your speaker grilles. 


More power, Igor! 

A major advantage of this kind of arcade 
machine build is that there are no internal power 
supplies to bother with. There’s enough space to 
mount a plug bar inside most cabinets, and you can 
use this to power the monitor, Raspberry Pi, and any 
extra transformers required for lights or speakers. 


Where to buy 


There are a number of UK and EU retailers 
specialising in self-assembly arcade cabinets and 
components. While it’s easiest to get everything in 
one place, you have to mix and match for specialist 
components such as GPIO-compatible wiring looms. 
* Arcade World UK - arcadeworlduk.com - supplies a 

wide range of kits and components; discount codes 

available for most non-furniture items 

Bitcade - magpi.cc/bitcadekits - UK arcade 

machine maker that also supplies kits 

Omnireto - omniretro.com — Spanish firm with a 

notable budget range 

Rockstar Print — rockstarprint.co.uk —- custom 

marquee and wrap printer 

SmallCab - smallcab.net - French supplier of arcade 

kits and hardware including GPIO-friendly wiring 





LED strip lighting is a popular choice for marquee 
panels, but you’ll need to buy a Molex power adapter 
to go with it, or repurpose a PC power supply. You 
can run a plug lead out of the back or optionally 
install an external power socket and switch, if you’re 
comfortable with simple electrical wiring. 


Room to build 

Before you start ordering, consider not only 
the space you have to house your cabinet, but also 
how much room you have to build in. Don’t get an 
untreated MDF cabinet unless you have a large, 
ventilated (and paint-resistant!) space where you 
can apply primer to each part, as well as appropriate 
eye and breathing protection. 1] 
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Warning! 
Paint and dust 


When sanding, sawing, 
or painting, be sure to 
use appropriate eye and 
breathing protection ina 
well-ventilated space. 


magpi.cc/diysafety 


WV You'll want to source 
durable joysticks 
and buttons for your 
arcade machine 
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Nik Rawlinson 





Esperanto- 
speaking, pencil- 
wielding, single- 
board computing 
fan who likes 
hyphens and 
remembers what 
that icon on the 


save button depicts. 


nikrawlinson.com 


WV Make sure Pi-hole is 


set to filter content on 
the interface through 
which it’s connected 
to your network 


File Edit Tabs 


Choose An Interface (prece epace to toggle selection) 


Set up P1-hole 
with Raspberry P1 


Pi-hole blocks ads, cookies - and whole sites if you choose - from your 
home network so you can browse more quickly and securely 


on a Raspberry Pi on your network. By 

connecting your other computers, tablets 
— and even your smartphone ~— to Raspberry Pi, 
rather than directly to your router, Pi-hole will 
interrogate their internet traffic and strip out 
unwanted content. With built-in lists for ad 
servers, its primary use is to block advertising, but 
you can just as easily bar social media and other 
sites you find distracting or objectionable. In this 
tutorial, we’ll show you how to set up Pi-hole 
on a Raspberry Pi and connect to it from another 
device on your network. 


p i-hole is a free web filtering tool that runs 


Locate Raspberry Pi 

Start with a fresh installation of Raspberry Pi 
OS connected to your local network (via an Ethernet 
cable or wireless LAN). Pi-hole only works if the 
other computers on your network know where to 
find it. Most routers assign IP (internet protocol) 
addresses dynamically, and there’s a chance your 
Raspberry Pi might move around the network and get 





<Cancel> 
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a new IP address. To ensure your other devices can 
always find it, we’re going to give your Raspberry Pia 
static IP address. Open a Terminal window by clicking 
the icon on the Raspberry Pi menu bar and enter: 


hostname -I 


This will tell you which IP address is currently 
assigned to your Raspberry Pi. Ours is 
192.168.1.148. Make a note of this number. 


Get your router's IP address 
Now do the same for your router’s IP 
address (the ‘default gateway’). Enter this 
command in Terminal: 





ipr 


Press ENTER, and note the first four sets of digits 
after ‘default via’. Ours is ‘192.168.1.1’. This is your 
router’s address. 


Update your configuration file 
We’re going to add this info to our 
configuration file so it never changes. Open 
Terminal and enter: 





sudo nano /etc/dhcpcd. conf 


At the bottom of the dhcpcd.conf file you will see 

an example of a static IP configuration. Delete the 
hashtags (‘#’) at the start to uncomment the ‘static 
IP address’ and ‘static IP routers’ lines. Replace the 
example IP address with the number from Step 1 and 
your router address from Step 2. See the dhcpcd.conf 









Pi-hole 


Total queries (4 clients) 


Fn on 


F 
4,356 


® Dashboard 


Percent Blocked 


15.6% 


Fed 
fat 
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code listing for an example of how our configuration 
looks (but don’t forget to use your own IP and 
router addresses). 

If your Raspberry Pi is connected to the router via 
an Ethernet cable, remove the comment ‘#’ before 
interface eth@. If you are connecting Raspberry Pi 
to your network with wireless LAN, replace it with 
interface wlang. 

Press CTRL+O to save your file (‘O’ stands for 
output) and CTRL+X to quit Nano, then enter 
sudo reboot and press ENTER to restart. 


Download the Pi-hole installer 

When it’s up and running again, you’re ready 
to install Pi-hole. First, download a copy of the latest 
build. Open a new Terminal window and enter: 


wget -O basic-install.sh 
https://install.pi-hole.net 
sudo bash ./basic-install.sh 


This will start the Pi-hole installation script. It 
will check which packages are already installed, 
and install the ones you need. Follow the 
instructions in the installation while reading 
through the following steps. 


Specify your interface 

After some preliminary configuration, 
the splash screen for the Pi-hole automated 
installer will appear, explaining that it’s about to 
“transform your device into a network-wide ad 


Total queries over last 24 hours 


my 


F 
So 


Be eer (@ Pihole-DietPi-Chromium Ellcigmypi: ~) V2 ~ 16:40 
S Pi-hok Ceti x + —| i] x 
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Pi-hole 


Domains on Blocklist 


87,424 


Change 
password 


PN Uaavessimelenelelrene(e)aareliatceslas 
blocked, keeping us safe from 
malicious sites and removing ads 


_ 


™ Pi-hole uses an external 
DNS provider to locate 
guthorised resources @ 


You can change 
your password 
at the command 
prompt with the 
command: 

sudo pihole 

-a -p 





a 





blocker”. Press ENTER on each of the first three 
screens. On the ‘Choose an interface’ screen, use 
the arrows and SPACE bar to select either etho 
or wlano for a wired or wireless connection, as 
appropriate to your setup. Press TAB to select OK 
and hit ENTER. 


Choose a DNS provider 

Any internet resources, like images, text 
and code, that don’t trip Pi-hole’s safeguards 
will be retrieved from the servers where they’re 
stored and fed back to the device that requested 
them. Pi-hole uses an external DNS provider to 
locate these authorised resources, and gives youa 
choice of nine to pick from, plus a custom option 
for business users running their own DNS server. 
If you’re happy to stick with the default, which is 
Google, press TAB to select OK, then press ENTER. 
If not, select an alternative from the list, press TAB 
to select OK, then ENTER to move to the next page. 


You'll Need 


Confirm your block list > Raspberry Pi 


To save you specifying every server that 
should be blocked, Pi-hole is configured to use a pre- 
compiled list (‘StevenBlack’) to which you can add 
your own entries once it’s up and running. Leave the 
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» Pi-hole installer 
pi-hole.net 


» Your router details 
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File Edit Tabs Help 


| installation complete: | 


it al your devices Lo use Lhe Pi-hole as their ONS server 
using: 


1927,168.1.148 
IPWwe: Hot Configured 


If you set o mew IP address, you should restart the Pi. 
The install log is in /cte/piholc. 


Wiew the web interface at http://pi.hole/admin or 
http://192.160.1.140/admin 


Your Admin Webpage login paseword is wkew4xuP 





A When you've finished 
setting up Pi-hole, 
make a note of the 
IPv4 address and 
password for later use 


existing list selected by pressing TAB to select OK and 
press ENTER. Ensure both IPv4 and IPvo are selected 
on the ‘Select Protocols’ screen, and select OK. 

At this point, the installer checks that you’re 
happy with the numeric (IP) address Raspberry Pi 
is using. Check that the IP address and Gateway 
match your IP address and router’s address. As 
we configured this in Step 3, and set it to remain 
fixed, step through the next two screens without 
worrying too much over the warnings that static 
addresses might cause conflicts. 





Install the web interface 

You can use Pi-hole’s web interface to 
monitor your web traffic and temporarily deactivate 
web filtering when you need to access resources 
that would otherwise have been blocked. It’s also 
where you’ll add entries to and remove them from 
the block list. Make sure ‘On’ is selected when asked 
if you want to install the web admin interface, then 
press TAB to select OK and press ENTER. Do the 
same on any following screens to install the lighttpd 
web server that will host the web interface, and the 
PHP modules that it relies on. 


TopTip @& 


Permanently 
powered 


Keep the 
Raspberry Pi 
running Pi-hole 
switched on. 

If not, your 
connected 
devices will resort 
to the fallback 
DNS server. 


To log or not to log 
When you reach the ‘log queries’ screen, 
decide whether you want to log queries or not. 








DOWNLOAD 
THE FULL CODE: 


yy) magpi.cc/github 










dhcpcd.cont 


» Language: Bash 


QQ@1. interface wlan@ # use eth@ for wired Ethernet 
Q@2. static ip _address=192.168.1.148/24 # Use your Raspberry Pi's IP address 
QQ@3. static routers=192.168.1.254 # Use your Router's IP address 

static domain_name_servers=192.168.1.254 8.8.8.8 
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They’ re useful if you want to look back and see 
what’s been requested and blocked on your 
network, but not critical to the effective running 
of Pi-hole. If you want to save space on your 
Raspberry Pi’s microSD card, or reduce the 
number of times your Raspberry Pi writes to it 
(media cards can sustain a generous but limited 
number of write and wipe operations before they 
start to fail), you can turn off this option. We’re 
going to leave it on. 


Select a privacy mode 

How much do you want to know about what’s 
happening on your network? Pi-hole next asks what 
level of detail it should record in its stats. Level 0, 
the default, logs everything, with higher numbers 
anonymising more and more data. If you’re never 
going to need to know what other users on your 
network are up to, you can set it to 3, but sticking 
with level o can be useful if you suspect processes 
installed somewhere on your network might be 
sending your personal information to remote servers, 
as you can trawl the logs for unfamiliar hosts. 


Specify your interface 

Pi-hole has all the information it needs 
to complete the setup process, the remainder of 
which is automated. 

When it’s completed, take a note of the IPv4 
address displayed on the final screen, and the 
Admin login password. Quit the installer and 
reboot Raspberry Pi with: 





sudo reboot 


At this point you might want to remove the screen, 
keyboard, and mouse. Locate your Raspberry Pi 
near your router if using wireless LAN or keep it 
connected via the Ethernet cable. From now on, we 
will access it via the local network. 


Using Pi-hole 

Now switch to another computer on your 
network. It can be another Raspberry Pi, or a Mac or 
PC (or even a smartphone or tablet). You will need 
to change the network settings on every device you 
want to filter through Pi-hole so it accesses your 
Raspberry Pi rather than your router directly. 





Manually configure each 
device for Pi-hole 


Configure a Windows device 

On a Windows computer, open Control Panel and 
click ‘View network status and tasks’. Click the 
hyperlink of your network connection (Ethernet 
or WiFi, followed by Properties. Double-click 
‘Internet Protocol Version 4 (TCP/IPv4)’. Click the 
radio button beside ‘Use the following DNS server 
address’ and, in the box beside ‘Preferred DNS 
server’, enter the IP address of your Raspberry Pi 
running Pi-hole. 

In the ‘Alternative DNS server’ box, enter either 
your router address, if you want to fall back on your 
ISP’s DNS server should there be any problem with 
Pi-hole, or 8.8.8.8 if you want to use Google’s DNS 
server instead. 


V_ Make sure Pi-hole is set to filter content on the interface through 
which it's connected to your network 


Internet Protocol Version 4 (TCP/IPv4) Properties ~ 


General Alternative Configuration 
You can get IP settings assigned automatically if your network supports 


this capability, Otherwise, you meted to ask your network administrator 
for the appropriate IP settings. 


(@) Obtain an IP address automatically 
(Use the following IP address: 


IP address: 


Subnet mack: 


li 


() Obtain DNS server address automatically 
(@) Use the following DNS server addresses: 


Preferred DNS server: 197.168. 1 .148 
Alternative DNS server: 8 .8.8.a4 


[| Validate settings upon exit 


Set up macOS 

Open System Preferences and choose Network. 
Choose the network interface from the sidebar 
(typically Wi-Fi or Ethernet) and click ‘Advanced’. 
Choose the DNS tab and click the ‘+’ (Add a DNS 
Server icon). Type the address of your Raspberry Pi 
running Pi-hole in the line that appears. You can 
optionally add another server, like your router’s 

IP address or 8.8.8.8 to use Google’s DNS server 
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: Network 


=" 'Wi-F| 

| Wi-Fi TCGRIP GNSS WINS BOS 1 Proxies Hardware i, 
< Specifying a second 

DNS Servers: Search Domains: DNS address gives 

192.168.1.148 your computer a 

[seas fallback that it will 
use if it can't reach 
your Pi-hole device 


+ — (Py or lve addresses + 


% Cancel OK 





as a fallback in the case of problems. Select the 
addresses of any existing DNS servers in the left- 
hand box, and click ‘-’ to delete them. 


TopTip @& 


Set up Linux 
To set up another Raspberry Pi to use Pi-hole as 


Beware 
its DNS server, switch to that Raspberry Pi, open changing 
Terminal and type: networks 


When you move 
your computer 

to a different 
network, you'll 
bypass Pi-hole. 
Change your DNS 
settings for every 
network you use. 


sudo nano /etc/dhcpcd.conf 
Move your cursor to the bottom of the file and add 
the following, replacing [ip address] with the 


numeric address of the device running Pi-hole: 


static domain_name_servers=[ip address | 





Press CTRL+X to exit and confirm that you want to 
save the file when asked. Now restart the dhcpcd 
service by typing: 


sudo service dhcpcd restart 


On a Linux PC running the Gnome interface, launch 
the Settings app and click Wi-Fi in the sidebar, 
followed by the cog beside your active network name. 
Click the IPv4 tab, then turn off the switch beside 
Automatic to the right of DNS. Enter the numeric 
address of your Pi-hole device in the field below, 
then click Apply. 


Run Pi-hole on your 
Raspberry Pi and 
enjoy the worldwide 
web without all those 
annoying ads 
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> Figure 1A Slider to 
set date and time 


Create GUIs 
with Python: 
Worlds worst 


Learn good GUI design by doing it all wrong first! 


t’s time to really go to town with your GUIs 
and experiment with different widgets, 

colours, fonts, and features. Like most 
experiments, it’s likely that you won’t get it right 
first time! In fact, you are going to explore the 
wrong way to approach creating your GUI. 





It’s hard to read 


The right choice of GUI colour and font are 
important. It’s important that the contrast 
between background and text colour ensure that 
your GUI is easily readable. What you shouldn't 
do is use two very similar colours. 

Import the widgets at the top of the code: 


from guizero import App, Text 
Create an app with a title: 


app = App("it's all gone wrong") 
title = Text(app, text="Some hard to read 
text") 


app.display() 


Experiment by changing the colours, font, and 
text size (see worst1.py listing). Our choices are 
not the best! 


app = App("it's all gone wrong", bg="dark 
green") 

title = Text(app, text="Some hard-to- 
read text", size="14", font="Comic Sans", 
color="green" ) 


It’s important that text on a GUI also stays around 
long enough to be read. It certainly shouldn’t 
disappear or start flashing. 

All widgets in guizero can be made invisible 
(or visible again) using the hide() and show() 
functions. Using the repeat function in guizero to 
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run a function every second, you can make your 
text hide and show itself and appear to flash. 

Create a function which will hide the text if it’s 
visible and show it if it’s not: 


def flash_text(): 
if title.visible: 
title.hide() 
else: 
title. show() 


Before the app is displayed, use repeat to 
make the flash_text function run every 1000 
milliseconds (1 second). 


app.repeat(1000, flash _text) 


app.display() 


Your code should now look like worst2.py. Test 
your app: the title text should flash, appearing and 
disappearing once every second. 


The wrong widget 

Using an appropriate widget can be the 
difference between a great GUI and one which is 
completely unusable. 


nn te - ge. 
=—ntor weer mone 
| SET CAL mat AE 
| Sip ieatcleat Kethanteassc sts 


mofo =| aft =|) jn =] =| =| -| | 


Which widget would you use to enter a date? A 
TextBox? Multiple Combos? A TextBox would be 
more flexible but would require validation and 
formatting. Multiple Combos for year, month, 
and day wouldn’t require validating but would be 
slower to use. 

Using a Slider to set a date and time (Figure 1), 
as in the worst3.py code example, is not a great 
idea, though. 

The Slider widget returns a number between 0 
and 999,999,999. This is the number of seconds 
since 1 January 1970. The function ctime() is 
used to turn this number into a date and time. 

Getting text from your uSer is simple: a TextBox 
or a multi-line TextBox should fulfil all your 
needs. Is it too simple, though? Does this require 
too much typing? 

What about the user who just wants to use 
a mouse? Perhaps a series of Combos each 
containing all the letters in the alphabet would be 
better (Figure 2)° Start by importing the guizero 
widgets and ascii_letters. 


from guizero import App, Combo 
from string import ascii_letters 


ascii_letters isa list containing all the 
‘printable’ ASCII characters which you can use as 
the options for the Combo. 
Create a single Combo which contains all the 
letters and displays the app. 
a_letter = Combo(app, options=" " 
letters, align="left") 


+ ascii_ 


app.display() 


Your program should now resemble worst4.py. 
Running it, you will see a single Combo which 
contains all the letters plus a space and is aligned 
to the left of the window. 

To get a line of letters together, you could 
continually add Combo widgets to your app, e.g.: 


a_letter = Combo(app, options= + aScii_ 
letters, align="left") 

b_letter = Combo(app, options=" " + ascii_ 
letters, align="left") 

c_letter = Combo(app, options=" " + ascii_ 


letters, align="left") 


By aligning each Combo widget to the left, the 
widgets are displayed next to each other against 
the left edge. 
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worst1.py 


» Language: Python 3 


001. 
0@2. 
003. 
004. 
005. 
006. 
007. 
008. 
0e9. 
010. 
011. 
012. 


DOWNLOAD 
THE FULL CODE: 


) magpi.cc/guizerocode 









# Imports --------------- 


from guizero import App, Text 


app = App("it's all gone wrong", bg="dark green") 


title = Text(app, text="Hard to read", size="14", font="Comic 
Sans", color="green") 


app.display() 


Set the date with the slider 
Thu Jun 16 08:28:37 1977 
235294117 


_ 





A Figure 2 Combos to choose letters 


worst2.py 


» Language: Python 3 


001. 
0@2. 
003. 
004. 
005. 
006. 
007. 
008. 
0e9. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
Q21. 
Q22. 
023. 
024. 


# Imports --------------- 


from guizero import App, Text 


# Functions ------------- 
def flash_text(): 
if title.visible: 
title.hide() 


else: 
title.show() 


app = App("it's all gone wrong", bg="dark green") 


title = Text(app, text="Hard to read", size="14", font="Comic 
Sans", color="green") 


app.repeat(1000, flash_text) 


app.display() 
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worst3.py 


» Language: Python 3 
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Window widget 


Pop-up boxes can be used to ask users questions, but 
they are really simple. 
If you want to do show additional information or ask 


sis ee for supplementary data, you could use the Window 
Q@3. from guizero import App, Slider, Text widget to create multiple windows. 

G04. from time import ctime Window is used in a similar way to App and has 
005. many of the same functions. 

006. 

ae Pe sigan nel er tctonnnares from guizero import App, Window 

Q@9. def update date(): 

Q10. the_date.value = ctime(date_slider.value) app = App("Main window" ) 

Q11. window = Window(app, "2nd Window" ) 

012. 

913. # App ------------------- : 

014. app.display() 


Q@15. app = App("Set the date with the slider") 

Q16. the_date = Text(app) 

Q@17. date_slider = Slider(app, start=@, end=999999999, 
Q@18. command=update_date) 

Q@19. 

Q@20. app.display() 


You can control whether a Window is on screen using 
the show() and hide() methods. 


window. show() 
window. hide() 


An app can be made to wait for a window to be closed 
after it has been shown, by passing True to the wait 
parameter of show. For example: 


worst4.py 


window. show(wait=True) 
» Language: Python 3 
You can find out more about how to use multiple 
windows in the guizero documentation: 
lawsie.github.io/ guizero/multiple_windows. 


O01, # IMpOrts =-<-==-===-=-s===-- 
Q@0@2. from guizero import App, Combo 
Q@3. from string import ascii_letters 





Qe4. 

Q05. 

a a Alternatively, you could use a for loop, create a 
008. app = App("Enter your name") list of letters, and append each letter to the list, as 
209. shown in worst5.py. 

Q10. a _letter = Combo(app, options=" “ + ascii_letters, align="left") Try both these approaches and see which you 
Q11. 


prefer. The for loop is more flexible as it allows you 
to create as many letters as you like. 


Q12. app.display() 


> Figure 3 Pop-ups 
Pointless POP-UP No terrible GUI would be complete without a 

pop-up box. guizero contains a number of pop- 
up boxes, which can be used to let users know 
something important or gather useful information. 
They can also be used to irritate and annoy users! 

First, create an application which pops up a 
pointless box at the start to let you know the 
application has started. 


‘wt pf 


f Well done you started the 
2 application 


from guizero import App 


app = App(title="pointless pop-ups") 
Figure 3 app.info("Application started", "Well done 
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worst5.py 


» Language: Python 3 


0e1. 
002. 
0@3. 
004. 
Q@5. 
006. 
007. 
008. 
0e9. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 


# Imports --------------- 


from guizero import App, Combo 
from string import ascii_letters 


app = App("Enter your name") 


name_letters = [] 
for count in range(10): 

a_letter = Combo(app, options=" " + ascii_letters, 
align="left") 

name_letters.append(a_letter) 


app.display() 


05-worlds-worst-gui.py 


» Language: Python 3 


0e1. 
0@2. 
003. 
004. 
Q@5. 
006. 
007. 
008. 
0e9. 
010. 
011. 
012. 
O13; 
014. 
Q15. 
016. 


from guizero import App, PushButton 
def are_you_sure(): 
if app.yesno("Confirmation", "Are you sure?"): 
app.info("Thanks", "Button pressed") 
else: 
app.error("Ok", "Cancelling") 
app = App(title="pointless pop-ups") 


button = PushButton(app, command=are_you_sure) 


app.info("Application started", "Well done you started the 
application") 


app.display() 


Create Graphical User 
Interfaces with Python 


For further tutorials on how 
to make your own GUIs with 
guizero, take a look at our 
book, Create Graphical User 
Interfaces with Python. Its 
156 pages are packed with 
essential info and a range of 
exciting projects. 
magpi.cc/pythongui 
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Figure 4 





A Figure 4 Yes, we're sure! 





you started the application") 


app.display() 


Running your application, you will see that an 
‘info’ box appears (Figure 3). The first parameter 
passed to info is the title of the window; the second 
parameter is the message. 

You can change the style of this simple pop-up 
by using warn or error instead of info. 

Pop-up boxes can also be used to get 
information from the user. The simplest is a yesno 
which will ask the user a question and get a True or 
False response. This is useful if you want a user to 
confirm before doing something, such as deleting 
a file. Perhaps not every time that they press a 
button, though! Import the PushButton widget into 
your application: 


from guizero import App, PushButton 


Create a function which uses the yesno pop-up to 
ask for confirmation. 


def are_you_sure(): 
if app.yesno("Confirmation", "Are you 
sure?"): 
app.info("Thanks", "Button 
pressed" ) 
else: 
app.error( "Ok", "Cancelling" ) 


Add the button to your GUI which calls the 
function when it is pressed. 


button = PushButton(app, command=are_you_ 
sure) 


Your code should now resemble 05-worlds-worst- 
gui.py. When you run the application and press 
the button, you will see a pop-up asking to you 
confirm with a Yes or No (Figure 4). 

You can find out more about the pop-up boxes in 
euizero at lawsie.github.io/guizero/alerts. 

How about combining all of these ‘features’ into 
one great GUI? 
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Create games and fun Python programs 


Learn how to create your own graphical ' 
user interfaces aa 
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Use windows, text boxes, buttons, 
images, and more 


Learn about event-based programming 





for your Python projects 


Explore good (and bad) user 
interface design 


# How to build windows, buttons, and widgets 
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“@ The TRON cab had 
two game controllers: 
a rotary wheel and 
a joystick. 


> Battle against Al 
enemies in the original 
arcade classic. 
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MARK VANSTONE 


Ed 


t the beginning of the 1980s, 
Disney made plans for an 
entirely new kind of animated 
movie that used cutting- 
edge computer graphics. 

The resulting film was 1982's TRON, and 

it inevitably sparked one of the earliest 
tie-in arcade machines. The game featured 
several minigames, including one based on 


in 
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PYGAME ZERO TRON LIGHTCYCLES 


# “@ Our homage to the 
TRON Light Cycle 
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classic arcade game. 


the Light Cycle section of the movie, where 
players speed around an arena on high- 
tech motorbikes, which leave a deadly trail 
of light in their wake. If competitors hit any 
walls or cross the path of any trails, then 
it's game over. Players progress through 
the twelve levels which were all named 
after programming languages. In the Light 
Cycle game, the players compete against 
Al players who drive yellow Light Cycles 
around the arena. As the levels progress, 
more Al Players are added. 

The TRON game, distributed by Bally 
Midway, was well-received in arcades, and 
even won Electronic Games Magazine's 
(presumably) coveted Coin-operated Game 
of the Year gong. Although the arcade game 
wasn't ported to home computers at the 
time, several similar games - and outright 
clones - emerged, such as the unsubtly 
named Light Cycle for the BBC Micro, Oric, 
and ZX Spectrum. 

The Light Cycle minigame is essentially a 
variation on Snake, with the player leaving a 
trail behind them as they move around the 


Code a Light Cycle arcade minigame 





Code a Light Cycle 
arcade minigame 


Speed around an arena, avoiding walls and deadly trails 


screen. There are various ways to code this 
with Pygame Zero. In this sample, we'll focus 
on the movement of the player Light Cycle 
and creating the trails that are left behind as 
it moves around the screen. We could use 
line drawing functions for the trail behind 
the bike, or go for a system like Snake, where 
blocks are added to the trail as the player 
moves. In this example, though, we're going 
to use a two-dimensional list as a matrix of 
positions on the screen. This means that 
wherever the player moves on the screen, 
we can set the position as visited or check 
to see if it's been visited before and, if so, 
trigger an end-game event. 

For the main draw() function, we first blit 
our background image, which is the cross- 
hatched arena, then we iterate through our 
two-dimensional list of screen positions 
(each 10 pixels square) displaying a square 
anywhere the Cycle has been. The Cycle is 
then drawn and we can add a display of the 
score. The update() function contains code to 
move the Cycle and check for collisions. We 
use a list of directions in degrees to control 


su is HTHAPES \ 
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Wireframe 


This tutorial first appeared in Wireframe, our 
sister magazine that lifts the lid on the world 
of video games. Every issue includes tutorials 
and in-depth interviews, along with news and 
reviews of the latest indie and triple-A games. 


To find out more, visit their website at wfmag.cc. 


Check out their subscription offers at 
wfmag.cc/subscribe. 


ee 


the angle the player is pointing, and another 
list of x and y increments for each direction. 
Each update, we add x and y co-ordinates 
to the Cycle actor to move it in the direction 
that it’s pointing, multiplied by our speed 
variable. We have an on_key_down() function 
defined to handle changing the direction of 
the Cycle actor with the arrow keys. 

We need to wait a while before checking 
for collisions on the current position, as the 
Cycle won't have moved away for several 
Updates, So each screen position in the 
matrix is actually a counter of how many 
Updates it’s been there for. We can then test 
to see if 15 updates have happened before 
testing the square for collisions, which gives 
our Cycle enough time to clear the area. 

If we do detect a collision, then we can 
Start the game-end sequence. We set the 
gamestate Variable to 1, which then means 
the update ) function uses that variable 

as a counter to run through the frames of 
animation for the Cycle’s explosion. Once it 
reaches the end of the sequence, the game 
stops. We have a key press defined (the 
SPACE bar) in the on_key_down() function to 
call our init¢) function, which will not only 
Set up variables when the game starts, but 
sets things back to their starting state. 

So, that’s the fundamentals of the 
player Light Cycle movement and collision 
checking. To make it more like the original 
arcade game, why not try experimenting 
with the code and adding a few computer- 
controlled rivals? @ 
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Light Cycles in Python ees 


icelaameliin elon 
wfmag.cc/ 
working on your system, you'll need to install Pygame Zero — full instructions are wfmag47 


available at wfmag.cc/pgzero. 


Here's Mark's code for a Light Cycle minigame straight out of TRON. To get it 





# TRON 


speed = 3 
dirs = [0,90,180,270] 
moves = [(®,-1),(-1,0),(0,1),(1,0)] 


def draw(): 
screen.blit( "background", (@, 2)) 
for x in range(Q, 79): 
for y in range(@, 59): 
if matrixL[x]L[y] > @: 
matrix[x][y] += 1 
screen. blit( "dot", ((x*10)-5, (y*10)-5)) 
bike.draw() 
screen.draw.text("SCORE : "+ str(score), center=(400, 588), owidth=0.5, 
ocolor=(0,255,255), color=(0,0,255) , fontsize=28) 


def update(): 
global matrix, gamestate, score 
if gamestate == 
bike.angle = dirs[bike.direction] 
bike.x += moves[bike.direction][0]*speed 
bike.y += moves[bike.direction][1 ]*speed 
score += 10 
if matrix[int(bike.x/10)J[Lint(bike.y/10)] < 15 : 
matrixLint(bike.x/10)J]Lint(bike.y/10)] += 1 
else: 
gamestate = 1 
if bike.x < 60 or bike.x > 750 or bike.y < 110 or bike.y > 525: 
gamestate = 1 
else: 
if gamestate < 18: 
bike.image = "bike"+str(int(gamestate/2)) 
bike.angle = dirs[bike.direction] 
gamestate += 1 


def on_key_down(key): 
if key == keys.LEFT: 
bike.direction += 1 
snapBike() 
if bike.direction == 4 : bike.direction = Q 
if key == keys.RIGHT: 
bike.direction -= 1 


snapBike() 

if bike.direction == -1 : bike.direction = 3 
if key == keys.SPACE and gamestate == 18: 

init() 


def snapBike(): 
bike.x = int(bike.x/10)*10 
bike.y = int(bike.y/10)*10 


def init(): 
global bike,matrix, gamestate, score 
bike = Actor('bikel', center=(400, 500)) 
bike.direction = 0 
matrix = [[@ for y in range(60)] for x in range(80)] 
gamestate = score = 0 


init() 
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WV Figure 1A basic 
three-light traffic 
light system 
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traffic light controller 


Create your own mini pedestrian crossing system using 
g Raspberry Pi Pico, multiple LEDs, and a push-button 


icrocontrollers can be found in almost all 
the electronic items you use on a daily basis 
— including traffic lights. A traffic light 
controller is a specially built system which changes 
the lights on a timer, watches for pedestrians looking 
to cross, and can even adjust the timing of the lights 
depending on how much traffic there is — talking 

to nearby traffic light systems to ensure the whole 
traffic network keeps flowing smoothly. 

While building a large-scale traffic management 
system is a pretty advanced project, it’s simplicity 
itself to build a miniature simulator powered by your 
Raspberry Pi Pico. With this project, you’ ll see how 
to control multiple LEDs, set different timings, and 
how to monitor a push-button input while the rest 
of the program continues to run using a technique 
known as threading. 

For this project, you’ ll need your Pico; a 
breadboard; a red, a yellow or amber, and a green 


M 


“CEL EUL CEL LEL CELE 
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LED; three 330. resistors; an active piezoelectric 
buzzer; and a selection of male-to-male (M2M) 
jumper wires. You’1l also need a micro USB cable, and 
to connect your Pico to your Raspberry Pi or other 
computer running the Thonny MicroPython IDE. 


A simple traffic light 
Start by building a simple traffic light system, as 
shown in Figure 1. Take your red LED and insert it 
into the breadboard so it straddles the centre divide. 
Use one of the 330. resistors, and a jumper wire if 
you need to make a longer connection, to connect the 
longer leg — the anode — of the LED to the pin at the 
bottom-left of your Pico as seen from the top with 
the micro USB cable uppermost, GP15. If you’re using 
a numbered breadboard and have your Pico inserted 
at the very top, this will be breadboard row 20. 

Take a jumper wire and connect the shorter leg — 
the cathode — of the red LED to your breadboard’s 
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eround rail. Take another, and connect the ground 
rail to one of your Pico’s ground (GND) pins — in 
Figure 1, we’ve used the ground pin on row three of 
the breadboard. 

You’ve now got one LED connected to your Pico, 
but a real traffic light has at least two more for a 
total of three: a red light to tell the traffic to stop, an 
amber or yellow light to tell the traffic the light is 
about to change, and a green LED to tell the traffic it 
can go again. 

Take your amber or yellow LED and wire it to your 
Pico in the same way as the red LED, making sure the 
shorter leg is the one connecting to the ground rail of 
the breadboard and that you’ve got the 330 Q resistor 
in place to protect it. This time, though, wire the 
longer leg — via the resistor — to the pin next to the 
one to which you wired the red LED, GP14. 

Finally, take the green LED and wire it up the same 
way again — remembering the 330. resistor — to 
pin GP13. This isn’t the pin right next to pin GP14, 
though — that pin is a ground (GND) pin, which you 
can see if you look closely at your Pico: the ground 
pins all have a square shape to their pads, while the 
other pins are round. 

When you’ve finished, your circuit should match 
Figure 1: a red, a yellow or amber, and a green LED, 
all wired to different GPIO pins on your Pico via 
individual 330 Q resistors and connected to a shared 
eround pin via your breadboard’s ground rail. 

To program your traffic lights, connect your 
Pico to your Raspberry Pi (or other computer) and 
load Thonny. Create a new program, and start by 
importing the machine library so you can control 
your Pico’s GPIO pins: 


import machine 


You’ll also need to import the utime library, so you 
can add delays between the lights going on and off: 


import utime 


As with any program using your Pico’s GPIO pins, 
you'll need to set each pin up before you can 
control it: 


led_red = machine.Pin(15, machine.Pin.OUT) 
led_amber = machine.Pin(14, machine.Pin.OUT) 
led_green = machine.Pin(13, machine.Pin.OUT) 


These lines set pins GP15, GP14, and GP13 up as 
outputs, and each is given a descriptive name to 
make it easier to read the code: ‘led’, so you know the 
pins control an LED, and then the colour of the LED. 


Real traffic lights don’t run through once and stop 
— they keep going, even when there’s no traffic there 
and everyone’s asleep. So that your program does the 
Same, you’ll need to set up an infinite loop: 


while True: 


Each of the lines beneath this need to be indented by 
four spaces, so MicroPython knows they form part of 
the loop; when you press the ENTER key Thonny will 
automatically indent the lines for you. 


led_red.value(1) 
utime.sleep(5) 
led_amber.value(1) 
utime.sleep(2) 
led_red.value(@) 
led_amber.value(@) 
led_green.value(1) 
utime.sleep(5) 
led_green.value(@) 
led_amber.value(1) 
utime.sleep(5) 
led_amber.value(@) 


Click the Run icon and save your program to your 
Pico as Traffic_Lights.py. Watch the LEDs: first the 
red LED will light up, telling the traffic to stop; next, 
the amber LED will come on to warn drivers the 
lights are about to change; next both LEDs switch 
off and the green LED comes on to let traffic know it 
can pass; then the green LED goes off and the amber 
one comes on to warn drivers the lights are about to 
change again; finally, the amber LED goes off - and 
the loop restarts from the beginning, with the red 
LED coming on. 


™ The pattern will loop until 
you press Stop, because It 
forms an infinite loop @ 


The pattern will loop until you press the Stop 
button, because it forms an infinite loop. It’s based 
on the traffic light pattern used in real-world traffic 
control systems in the UK and Ireland, but sped up 
— giving cars just five seconds to pass through the 
lights wouldn’t let the traffic flow very freely! 

Real traffic lights aren’t just there for road 
vehicles, though: they are also there to protect 
pedestrians, giving them an opportunity to cross a 
busy road safely. In the UK, the most common type 
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get started with 
MicroPython 


an Raspberry Pi Pico 





Get Started with 
MicroPython 
on Raspberry 
Pj Pico 


For more physical 
computing 
projects to try on 
your Raspberry 
Pi Pico, grab a 
copy of the new 
book, Get Started 
with MicroPython 
on Raspberry Pi 
Pico. As well as 
learning how to 
use Raspberry 

Pi Pico’s pins 

as inputs and 
outputs, you'll 
build a simple 
game, measure 
temperatures, 
save and load 
data to your 
Pico’s file system, 
and even make 
a burglar alarm 
for your room. 
Get Started with 
MicroPython on 
Raspberry Pi Pico 
is available now 
from magpi.cc/ 
picobook. 
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A Figure 2 A puffin 
crossing traffic 
light system 
















of these lights are known as pedestrian-operated 
user-friendly intelligent crossings or puffin crossings. 

To turn your traffic lights into a puffin crossing, 
you’ ll need two things: a push-button switch, so 
the pedestrian can ask the lights to let them cross 
the road; and a buzzer, so the pedestrian knows 
when it’s their turn to cross. Wire those into your 
breadboard as in Figure 2, with the switch wired to 
pin GP16 and the 3V3 rail of your breadboard, and 
the buzzer wired to pin GP12 and the ground rail of 
your breadboard. 

If you run your program again, you’ll find the 
button and buzzer do nothing. That’s because you 
haven’t yet told your program how to use them. In 
Thonny, go back to the lines where you set up your 
LEDs and add the following two new lines below: 


button = machine.Pin(16, machine.Pin.IN, 
machine.Pin.PULL_DOWN) 
buzzer = machine.Pin(12, machine.Pin.OUT) 


This sets the button on pin GP16 up as an 

input, and the buzzer on pin GP12 as an output. 
Remember, your Raspberry Pi Pico has built-in 
programmable resistors for its inputs, which we 
are setting to pull-down mode for this project. This 
means that the pin’s voltage is pulled down to oV 
(and its logic level is 0), unless it is connected to 
3.3V power (in which case its logic level will be 1 
until disconnected). 

Next, you need a way for your program to 
constantly monitor the value of the button. In the 
last two issues’ Pico tutorials, all your programs 
have worked step-by-step through a list of 
instructions — only ever doing one thing at a time. 
Your traffic light program is no different: as it 
runs, MicroPython walks through your instructions 
step-by-step, turning the LEDs on and off. 
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For a basic set of traffic lights, that’s enough; for 
a puffin crossing, though, your program needs to be 
able to record whether the button has been pressed 
in a way that doesn’t interrupt the traffic lights. To 
make that work, you’1l need a new library: _ thread. 
Go back to the section of your program where you 
import the machine and utime libraries, and import 
the _thread library: 


import _thread 


A thread or thread of execution is, effectively, a 
small and partially independent program. You can 
think of the loop you wrote earlier, which controls 
the lights, as the main thread of your program — 
and using the _ thread library you can create an 
additional thread, running at the same time. 

An easy way to visualise threads is to think of 
each one as a Separate worker in a kitchen: while 
the chef is preparing the main dish, someone else is 
working on a sauce. At the moment, your program 
has only one thread — the one which controls the 
traffic lights. The RP2040 microcontroller which 
powers your Pico, however, has two processing 
cores — meaning, like the chef and the sous chef in 
the kitchen, you can run two threads at the same 
time to get more work done. 

Before you can make another thread, you’1l need 
a way for the new thread to pass information back 
to the main thread — and you can do this using 
global variables. The variables you’ve been working 
with prior to this are known as local variables, and 
only work in one section of your program, a global 
variable works everywhere, meaning one thread 
can change the value and another can check to see 
if it has been changed. 

To start, you need to create a global variable. 
Below your buzzer = line, add the following: 


global button_pressed 
button_pressed = False 


This sets up button_pressed as a global variable, and 
gives it a default value of False — meaning when the 
program starts, the button hasn’t yet been pushed. 
The next step is to define your thread, by adding the 
following lines directly below — adding a blank line, 
if you want, to make your program more readable: 


def button_reader_thread(): 
global button_pressed 
while True: 
if button.value() == 1: 
button_pressed = True 
utime.sleep(@.01) 


The first line you’ve added defines your thread and 
gives it a descriptive name: it’s a thread to read the 
button input. Like when writing a loop, MicroPython 
needs everything contained within the thread to 
be indented by four spaces — so it knows where the 
thread begins and ends. 

The next line lets MicroPython know you will be 
changing the value of the global button_pressed 
variable. If you only want to check the value, you 
wouldn’t need this line — but without it you can’t 
make any changes to the variable. 


™ Only when the button Is 
pressed will the final line of 
your thread run & 


Next, you’ve set up a new loop — which means a 
new four-space indent needs to follow, for eight 
in total, so MicroPython knows both that the loop 
is part of the thread and the code below is part of 
the loop. This nesting of code in multiple levels 
of indentation is very common in MicroPython, 
and Thonny will do its best to help you by 
automatically adding a new level each time it’s 
needed — but it’s up to you to remember to delete 
the spaces it adds when you’re finished with a 
particular section of the program. 

The next line is a conditional which checks to 
see if the value of the button is 1. Because your 
Pico is using an internal pull-down resistor, when 
the button isn’t being pressed the value read is 
O — meaning the code under the conditional never 
runs. Only when the button is pressed will the 
final line of your thread run: a line which sets the 


button_pressed variable to True, letting the rest of 
your program know the button has been pushed. 
Finally, we add a very short (0.01 second) delay to 
prevent the while loop running too fast. 

You might notice there’s nothing in the thread 
to reset the button_pressed variable back to False 
when the button is released after being pushed. 
There’s a reason for that: while you can push the 
button of a puffin crossing at any time during the 
traffic light cycle, it only takes effect when the 
light has gone red and it’s safe for you to cross. 

All your new thread needs to do is to change the 
variable when the button has been pushed; your 
main thread will handle resetting it back to False 
when the pedestrian has safely crossed the road. 

Defining a thread doesn’t set it running: it’s 
possible to start a thread at any point in your 
program, and you’ll need to specifically tell the 
_ thread library when you want to launch the 
thread. Unlike running a normal line of code, 
running the thread doesn’t stop the rest of the 
program: when the thread starts, MicroPython 
will carry on and run the next line of your program 
even as it runs the first line of your new thread. 

Create a new line below your thread, deleting all 
of the indentation Thonny has automatically added 
for you, which reads: 


_thread.start_new_thread(button_reader _ 
thread, ()) 


This tells the _ thread library to start the thread you 
defined earlier. At this point, the thread will start 

to run and quickly enter its loop — checking the 
button thousands of times a second to see if it’s been 
pressed yet. The main thread, meanwhile, will carry 
on with the main part of your program. 

Click the Run button now. You’l see the traffic 
lights carry on their pattern exactly as before, with 
no delay or pauses. If you press the button, though, 
nothing will happen — because you haven’t added the 
code to actually react to the button yet. 

Go to the start of your main loop, directly 
underneath the line while True: , and add the 
following code — remembering to pay attention to 
the nested indentation, and deleting the indentation 
Thonny has added when it’s no longer required: 


if button_pressed == True: 
led red.value(1) 
for i in range(1@): 
buzzer.value(1) 
utime.sleep(@.2) 
buzzer.value(@) 
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Warning! 


Always remember that 
an LED needs a current- 
limiting resistor before 
it can be connected 
to your Pico. If you 
connect an LED without 
a current-limiting 
resistor in place, the best 
outcome is the LED will 
burn out and no longer 
work; the worst outcome 
is it could do the same to 
your Pico. 
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traffic_light_controller.py 
» Language: MicroPython 


QQ@1. import machine 

Q02. import utime 

QQ@3. import _thread 

004. 

Q05. led_red = machine.Pin(15, machine.Pin.OUT) 

Q@06. led_amber = machine.Pin(14, machine.Pin.OUT) 

Q07. led _green = machine.Pin(13, machine.Pin.OUT) 

Q08. button = machine.Pin(16, machine.Pin.IN, machine.Pin. 
PULL_DOWN) 

Q09. buzzer = machine.Pin(12, machine.Pin.OUT) 

Q10. 

Q11. global button_pressed 

Q@12. button_pressed = False 


Q@13. 

Q@14. def button_reader_thread(): 
Q15. global button_pressed 

016. while True: 

Q17. if button.value() == 1: 
Q18. button_pressed = True 
Q19. utime.sleep(0.@1) 

Q@2@. _thread.start new thread(button_reader_thread, ()) 
Q@21. 

Q@22. while True: 

Q23. if button_pressed == True: 
Q24. led red.value(1) 

Q@25. for i in range(1@): 
Q26. buzzer. value(1) 
Q27. utime.sleep(@.2) 
Q28. buzzer.value(@) 
Q@29. utime.sleep(@.2) 
Q30. global button_pressed 
Q31. button_pressed = False 
Q32. led _red.value(1) 

Q33. utime.sleep(5) 

Q34. led_amber.value(1) 

Q@35. utime.sleep(2) 

Q36. led _red.value(@) 

037. led_amber.value(0) 

038. led_green.value(1) 


Q39. utime.sleep(5) DOWNLOAD 
040. led_green.value(@) THE THE CODE: 


Q41. led_amber.value(1) 
Q42. utime.sleep(5) yy) magpi.cc/github 
043. led_amber.value(@) 
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utime.sleep(@.2) 
global button_pressed 
button_pressed = False 


This chunk of code checks the button_pressed 
global variable to see if the push-button switch 
has been pressed at any time since the loop last 
ran. If it has, as reported by the button reading 
thread you made earlier, it begins running a 
section of code which starts by turning the red 
LED on to stop traffic and then beeps the buzzer 
ten times — letting the pedestrian know it’s 
time to cross. 

Finally, the last two lines reset the button 
pressed variable back to False — so the next time 
the loop runs it won’t trigger the pedestrian 
crossing code unless the button has been pushed 
again. You’1l see you didn’t need the line global 
button_pressed to check the status of the variable 
in the conditional; it’s only needed when you 
want to change the variable and have that change 
affect other parts of your program. 

Your program should look like the code in 
traffic_light_controller.py. Click Run. At first, 
the program will run as normal: the traffic lights 
will go on and off in the usual pattern. Press the 
push-button switch: if the program is currently 
in the middle of its loop, nothing will happen 
until it reaches the end and loops back around 
again — at which point the light will go red and 
the buzzer will beep to let you know it’s safe to 
cross the road. The conditional section of code for 
crossing the road runs before the code you wrote 
earlier for turning the lights on and off in a cyclic 
pattern: after it’s finished, the pattern will begin 
as usual with the red LED staying lit for a further 
five seconds on top of the time it was lit while the 
buzzer was going. This mimics how a real puffin 
crossing works: the red light remains lit even 
after the buzzer has stopped sounding, so anyone 
who started to cross the road while the buzzer was 
going has time to reach the other side before the 
traffic is allowed to go. 

Let the traffic lights loop through their cycle a 
few more times, then press the button again to 
trigger another crossing. Congratulations: you’ve 
built your own puffin crossing! 
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Use Visual 





Studio Code with 


Raspberry P1 


Install and use Microsoft's development environment 


e love Microsoft’s Visual Studio 
W Code. It’s an excellent programming 
environment that Microsoft has made 
available for free. Installing Visual Studio Code 
is Just an apt command away, and once installed 
it’s a joy to use. 
It’s powerful too. While Raspberry Pi 
OS’s default IDEs (integrated development 
environments) Thonny and Geany are both 
beginner-friendly, Visual Studio Code is the 
recommended environment if you want to debug 
your code with a graphical interface. 
Visual Studio Code has deep integration with 
all the programming languages you are likely to 
use. Having support for everything from HTML, 
through to Python, and up to C++ ensures that you 
only have to learn one tool. 
Git support is baked in, so you can push and pull 
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Hattersley 


Lucy is editor of The 
MagPi and loves 

it when her code 
works. Although 

not the very first 
time. That's just a 
bit weird. 


magpi.cc 


remotely without having to switch to the Terminal. 


There’s a vast extensions marketplace offering 
a huge range of features, including code syntax 
extensions and code completions. 

All this makes it our go-to IDE for coding on 
Raspberry Pi. In this tutorial, we’re going to show 
you how to install Visual Studio Code and set it up 
for coding with Raspberry Pi and Pico. 


Install Visual Studio Code 


Visual Studio Code is now available in 
the default apt packages in Raspberry Pi OS. 
This means you can install it with just a simple 
Terminal command. 


Activity Bar makes it 
easy to navigate code 
and files, while the 
code preview makes 
it easy to scan long 
files. Here we are 
playing Boing from 
Code The Classics 





sudo apt update 
sudo apt install code -y 


64 | magpicc | Use Visual Studio Code with Raspberry Pi 


Click the Raspberry Pi applications menu and 
choose Programming > Visual Studio Code to 
open the program. 

If you’re looking to use Visual Studio Code along 
with the C/C++ SDK for Raspberry Pi Pico then it is 
best to use the Pico installation script (see ‘Install 
with Pico’). This installs Visual Studio Code along 
with the extensions needed to debug Pico. 


Explore Visual Studio Code 

When Visual Studio Code first opens, you 
will see the Welcome screen. This has quick links 
for creating a new file, opening a file, and links to 
various Help documents (including a cheat sheet). 
In the bottom -left you will see a ‘Show welcome 
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page on Startup’ option. Keep it ticked for now. 

On the left of the screen is the Activity Bar. Click 
the icons and a sidebar will appear; click the same 
icon again to get rid of it. The Activity Bar is used to 
navigate most of the features of Visual Studio Code 
while you code in the main window. 


Install the Python extension 

We have no code to play with at the moment. 
So let’s set up Visual Studio Code for use with Python 
and create the classic Hello World program. 

Click on the Extensions icon at the bottom of the 
Activity Bar. The Extensions sidebar will appear. 
From here you can install a wide range of features 
that expand Visual Studio Code. 


There's ag vast extensions 
marketplace offering a 
Nuge range of features 


Click the ‘Search extensions’ box, enter 
‘python’, and press ENTER. Because Python is 
such a popular language, hundreds of extensions 
will appear. Below each extension will be a short 
description and the name of the maker. We’re 
looking for the one made by ‘Microsoft’. It will 
almost certainly be the first result. Click on it and 


the extension details will appear in the Editor 
area. You will see the details and installation 
instructions. At the top are the number of times 
the extension has been installed (over 32 million 
at the time of writing) and a star rating from 
other Visual Studio Code users (four-and-a-half 
stars). These can give you an idea of how useful an 
extension will be. 

Note that we are not installing Python itself 
into Raspberry Pi OS. You will already have Python 
installed there. We are installing support for it in 
Visual Studio Code. Click the blue Install button. 


Create a Python file 

Now let’s create a Python file. Close the 
Extensions sidebar by clicking the Extensions 
icon and choose File > New File from the menu. A 
second tab will appear with Untitled-1. Choose File 
> Save As and name the file hello. py. 

Visual Studio Code will automatically detect you 
are working on a Python program and will load the 
Python extension from Step 3. 

On the first run, the Python Extension window 
will appear in the Editor, along with a notification in 
the bottom-right corner that ‘Linter pylint is 
not installed’. Pylint is a code analysis tool that 
checks your code against the PEP-8 style guide 
(magpi.cc/pylint). It’s handy to have around, but 
we’ re not going to use it here. Close the notification. 
Click on the hello.py file to switch back to it. 


Use Visual Studio Code with Raspberry Pi 


Read ine 


Top Tip 


Install with 
Pico 


If you have set 

up Raspberry Pi 
Pico with C/C++ 
development, 

you may already 
have Visual Studio 
Code installed 
(magpi.cc/picoc). 


You'll Need 


Raspberry Pl 
Raspberry Pi OS 


Internet connection 


magpi.cc 





65 


oo Ma 








» Visual Studio Code 


has extensions for all 
major programming 
languages. The 
Python extension 
provides features 
such as colour 

code syntax and 
Intellisense 

code completion 


TopTip @& 


Intellisense 


Microsoft's 
code-completion 
is known as 
‘Intellisense’ 
(magpi.cc/ 
intellisense) and 
you can expand 
code by pressing 
the TAB key. It's 

a great way to 

get parameter 
information, and 
to list members of 
objects (when you 
use dot notation). 
It's really helpful 
when coding. 


Blog 


Microsoft's Jim 
Bennett has written 
two blogs on Visual 
Studio Code for 
Raspberry Pi. Both 
are well worth 
taking a look at. 


Visual Studio Code 
on Raspberry Pi 
magpi.cc/ 
vscodeblog 


Code Remotely 
magpi.cc/ 
vscoderemotely 
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Run Hello World 


Enter the classic Hello World program in 
the editor window: 





print("Hello World") 


As you Start to type the ‘pr’ in ‘print’, IntelliSense 
will display options for Code Completion. You can 
carry on typing the code outt, or use the arrows to 
select acommand from the list. Select ‘print’ and 
press ENTER. 

Before running the program, we should pick 
the right interpreter. By default Visual Studio 
Code is set to use Python 2.7, whereas we want to 
code in Python 3.7 

Click on ‘Python 2.7.16 32-bit’ in the bottom- 
left corner (the version number may have 
updated) and a list of interpreters will appear at 
the top. Choose ‘Python 3.7.3 32-bit’ from the 
/usr/bin/python3 folder. 

To run the program, click the small green play 
icon in the top-right corner (hover the mouse on 
it to see ‘Run Python file in Terminal’. There are 
numerous other ways to run programs in Visual 
Studio code, including the Run and Debug option 
in the Activity Bar and the Run menu. 

A Terminal window will appear at the bottom 
and you will see ‘Hello World’ as the output. 


Debug 
Now you’ ve got the basics of Visual Studio 
Code, let’s split Hello World onto two lines: 


message = "Hello World" 
print(message) 
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Hover the mouse to the left of the ‘p’ on line 2 
and a small red dot will appear. Click it to seta 
breakpoint on line 2. Click Run and Debug in the 
Activity Bar and click Run and Debug. A list of 
configurations will appear at the top of the screen. 
Choose ‘Python File’ and press ENTER. 

The program will run line 1 and stop on line 2 
(with our breakpoint). The sidebar will display the 
Variables in your program (in this instance just 
‘message’ with a value of ‘Hello World’). 

At the top of the screen, a debug toolbar will 
appear with Continue, Step Over, Step Into, Step 
Out, Restart, and Stop options. Choose Continue to 
run line 2 of the program. 


07 REPL and Debug Console 

You can use REPL (Read-Eval-Print-Loop) 
in Visual Studio Code by choosing it from the 
Command Palette. Choose View > Command Palette 
(press CTRL+SHIFT+P) and enter ‘repl’. Choose 
‘Python: Start REPL’ from the command list. 

A REPL instance will appear in the Panel. You can 
now enter Python programs a line at a time. 

You can’t, however, interact with your Hello 
World program from REPL. A better approach is 
to use the Debug Console. Click Run and Debug 
again. The program should halt on line 2 with the 
breakpoint you Set in step 6. 

Now click on Debug Console in the console 
window. At the bottom of the screen is an 
interactive Debug Console REPL. Enter ‘message’ 
in it to see the contents of your message variable. 
The Debug console will say ‘Hello World’. 

You can adjust variables from the Debug 
Console REPL. Enter: 


message = "Hello from The MagPi" 


Notice that the message variable in the Run 
and Debug window changes to display the new 
variable contents. 

You can interact with the contents of the code 
using breakpoints, the Debug Console, and the 
debug toolbar. Click the Continue button to carry 
on running the program, and click on Terminal in 
the console to see the output message. 


GitHub integration 

Now that you have got the basics of coding 
and debugging, let’s get some code. We’re going to 
download some games from the Code The Classics 
book (magpi.cc/codetheclassics). 

Click on Source Control in the Activity Bar and 

click Clone Repository. Enter the following URL 
into the text field that appears. 


https://github.com/Wireframe-Magazine/Code- 
the-Classics.git 


A window will appear so you can choose a location 
for the files. Select the Documents folder and click 
Select Repository Location. 

The files will be downloaded and a notification 
will appear saying ‘Would you like to open the 
cloned repository®’ Click Open. 


Looking at detailed code 

The Explorer sidebar will display all the 
folders for the five games used in Code The 
Classics. Open Boing Master and click on boing. py. 

Notice that the right of the screen now displays 
a preview of all the code. You can use this to 
quickly zoom around the code. Click the Split 
Editor Right button in the top-right corner. This 
splits the window in half and enables you to view 
different parts of the code at the same time. You 
can continue to split the code into three, or more, 
views. Any changes you make will appear in all 
windows. Click the close icon on any view. 

The Explorer sidebar also presents folders for 
images, music, sounds, and other components. You 
can view the images in the Editor window. 

Press Run to play a game of Boing. Being able 
to view all the code and files in Visual Studio 
Code will make it much easier to understand the 
code construction. I 
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Cheap Trills for all 


Make a Trill Guitar that is so easy to play you won't believe it 


in Python, we are now going to show 

you how to make a standalone Trill MIDI 
guitar using a Pico Pi Controller. Here, we show 
you how to make it, and next month how the 
software makes it play. 


Lf aving seen how to read the Trill sensors 


How to play the flute 

In a satire of the long-running Blue Peter 
children’s program, Monty Python once famously 
told viewers how to play a flute, by blowing 
down one end and moving your fingers over the 
keys. That is a bit complex compared to how 
you can play our Trill Guitar. A Trill bar with 

a square below it looks like a guitar already. 

We had planned to make one when we started 
our look at the Trill sensors, but the arrival of 
Raspberry Pi Pico changed the direction of our 
design completely. 





WV Figure 1 Schematic of the Trill Guitar 
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The concept 

The idea is that we use the square Trill 
sensor as the guitar strings to strum or pluck, and 
the Trill bar sensor to change the chords, so you 
don’t have to learn the finger patterns for each 
chord. Then these touches are converted into 
MIDI note on and note off messages, and sent 
out toa MIDI sound generator, like the one we 
made in our MIDI sound box project in The MagPi 
#63 (magpi.cc/63). You could even combine this 
project with an amplifier and speaker for an all- 
in-one instrument if you like. 


The design 

The big advantage in using a Pico over 
something like Raspberry Pi Zero is that it consumes 
way less power, and you don’t have to be careful 
about turning it off, just disconnect the power. It 
also has zero boot time. A Pico design can run off 
three AA batteries; this project draws only 30 mA, so 
you should get around 65 hours of continuous play 
from a single set. Finally, adding an OLED display 
allows you to customise how the guitar works when 
you are away from your computer, and show you 
what chord you are playing. 


I2C buses 

As Pico has two I2C buses, we used Bus 1 for 
the Trill sensors, and Bus o for the OLED display. 
Changing the I2C speed on the Pico is simple, 

so we could run the Trill sensors at 400kHz and 
run the OLED display at 1MHz for a quick screen 
refresh rate. We chose one of those two-colour 
OLED displays, the sort that has a built-in filter 
over sections of the screen. We thought the 
yellow top line, with the rest in blue, looked good; 
however, any colour will work without modifying 
any code or hardware. 
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Schematic Construction You'll Need 
The schematic for our project is shown The circuit is built on a piece of stripboard 
in Figure 1, and is quite simple. Perhaps the 25 rows by 20 holes. For mounting, four 3mm holes Trill Bar and 
most involved part is the MIDI output circuit are drilled in each corner. Figure 2 shows the back Square sensor 
in the lower right corner. We used a BC212 of the stripboard, and you should cut the tracks at magpi.cc/trill 
PNP transistor, but any general-purpose PNP the places shown with the grey squares over the OLED 12864 l2C 
transistor will do. The two I2C buses each need holes, or grey bars between the holes. The front of display SSD 1306 
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Figure 2 The 
stripboard tracks to cut 
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Figure 4 Three sides 
added to the base 





downward-pointing pins soldered to it and plugs The sides 

into two rows of sockets, making it stand tall from The top and the base were taped together, 
the board. You can miss out the sockets if you want and the holes drilled through them both to ensure 
to solder your Pico directly onto the board. they aligned exactly. These holes are used for the 


pillars that hold the top and bottom apart, and 
Should be countersunk on the outside. The sides of 


Top TI p the guitar should be glued on one at a time to the 
The guitar body bottom. We used superglue, and a small engineer’s 
Mounting the The guitar body is constricted from 3mm set square to make sure they were vertical. Figure 4 
Trill sensors plywood; the drawings can be found on our GitHub shows when three sides had been added. The sides 
page (magpi.cc/pibakery). We printed these out around the display need to be bevelled to fit, but all 
Pass the cables on a piece of paper, and used spray mount glue to the other sides are butt joints. 
through the top of stick this temporarily to the wood sheets. Then, 
the case, and fix we used a combination of a tabletop saw and 
therm into:te top fretsaw (scroll-saw) to cut them out. Of the three 
fee ee large holes in the top, only the display’s needs to Finishing the case 
sided sticky tape. be neat, as the other two are covered by the Trill As more sides are glued in place, the 
sensors. Be sure to measure your OLED display structure becomes more solid. To finish off, we 
Figures The fonket because there are two slightly different sizes; the put a fillet of wood filler on the inside, as well as 
the board assembly drawings are for the larger one. in the gaps where the bevelled edges did not meet 
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Figure 6 


wr 


A Figure 6 Angle pins 
fitted to the display 


in line with the USB hole and 3mm holes drilled 
through into the base of the guitar. Following 

this, the board should be mounted on 3mm nylon 
standoff spacers, and the USB socket should be in 
the middle of the hole. Remove the board, sand off, 
and paint the whole case; we used red. 


™ The sides around the 
display need to be 
bevelled to fit @ 


I2C peripherals 

We soldered wires direct to the Trill 
sensors (Figure 5) rather than using the supplied 
connector, to reduce the height needed for a 
socket. Instead, we used pin headers on the 
board for all I2C connectors, and made up leads 
accordingly. With the OLED display, we removed 
the straight connector by inserting the blunt end 
of a Stanley knife between the PCB and plastic, 
and left the plastic pin holders off the board. This 
allowed the pins to be unsoldered one at a time, 
and a right-angled pin header fitted instead, as 
shown in Figure 6. 


Final assembly 

Note that the clock and data of the display 
were swapped over compared to the Trill sensors, 
so we kept the same board layout and just 
compensated for that in the lead from the display 
to the board. Figure 7 shows the whole assembly 
prior to fitting the top. The top and bottom of the 
box are held together using pillars; the trick is to 
have the pillars just a millimetre or two shorter 





than the sides in order to provide room for a bit of 
tension to be applied. The battery pack is held in 
place with adhesive foam pads. 


Software 

Next month we will look at the software to 
turn this into a fully-fledged instrument. To get 
good results is not as simple as you might think, 
but the complexity is all hidden from the user. We 
will use the two-dimensional reporting of a touch 
on the square sensor to not only pick which string 
is being plucked, but also the velocity (volume) of 
the MIDI note settings, so that you can play loud or 
soft depending on where you strum. The bar sensor 
can also be used in two modes, either defining the 
chord that is played or as feedback while modifying 


how the guitar plays. 
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BC212 


Note there are 
variants of the 
BC212 transistor 
with different pin 
configurations. The 
BC212L is not the 
same as the BC212. 





Figure 7 All parts 
assembled, now put 
the top on 
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Pico-fied 
Raspberry Pi projects 


Raspberry Pi Pico is already making waves as a cheaper, smaller 
alternative for traditional Raspberry Pi projects. By Rob Zwetsloot 





hen we first heard about Raspberry 
W Pi Zero, our minds raced with how 

the tiny version of Raspberry Pi could 
be used in similar ways to its credit-card- 
sized siblings, yet fit into even tinier spaces. 
Raspberry Pi Pico was no different; however, as it 
was now a microcontroller, different ways of using 
it sparked our imagination. 

While we knew it may be better suited to some 

classic Raspberry Pi projects than an actual 
Raspberry Pi, we did not consider the number of 





ways people would Pico-fy their projects. Here’s 
what people have made, and here are some ideas for 
you to pursue... 
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Motor controller 


A way to control robot motor control boards 
designed for Raspberry Pi with Raspberry Pi Pico - 
it’s different enough that you need a solution! 


How it works: 


We don’t want to say that this is cheating — it’s 
not — but it is an adapter for a board designed with 
Raspberry Pi Zero in mind. GPIO functions are 
programmable to be similar enough to work. This 
will possibly also be for sale at some point. 


Maker: 


Neil Lambeth (@NeilRedRobotics) 


Radio receiver 


EV Ne ol os elo) ieeraliG), Coe abe Meeksie job) ake) Woywey in ole ies) ove 
frequency, using this Raspberry Pi Pico project. 
(Geiss WO corre, 


es How it works: 
>. A TEA5767 module is used as an FM receiver 

and hooked up to a Pico. A tiny little LCD screen 

shows the frequency that Pico is currently tuned 
in to, using a little variable resistor to change the 
frequency just like on an older radio. Raspberry Pi 

r + Pico also has the ability to output sound, so with 
“4 9 rat tet vie i's some extra tweaks you could probably upcycle an 

‘oatas old radio or create your own. 








Maker: 
tkraspilabs (@tkraspilabs) 


Physical games and board games that 
have a little bit of electronics can be 
easily made or upgraded with a Pico. 


While someone has already made a 
Simon, we've not seen a dice roller or 
a Monopoly money system that allows 
for less cheating. With some motion 
sensors, they could easily be used to 
control open drones and such as well. 





a Ma 





i | FEATURE 






Simon says game 


Like the Simon toy of old, this Pico will flash 
specific LEDs in a sequence and you have to 
remember it, with each sequence getting longer 
anal, iim wloterorny,, loveiraletc. 


How it works: 

A simple script which lights an LED, stores what 
that was, and then waits for player input. Like 
much game code, it involves a lot of lists and 
checking of lists. You can find out more here on the 
website for it: magpi.cc/picosimon. 


Maker: 
GeekDude (@geektechstuff) 





Music and MIDI 
generation 


Whether it’s simple beeps or harmonic piano, 
it seems like Pico has extraordinary audio 
capabilities, as long as you can find them. 


How it works: 

The MagPi regular Mike Cook has made use of Pico’s 
PIO (Programmable Input/Output) to generate 
simple tones by toggling a pin, based on one of 

the Pico code examples: magpi.cc/pioihz. Kevin 
attached some audio gear to Pico and programmed 
it in MicroPython to produce MIDI notes, in this 
case some Bach: magpi.cc/picomidi. 


Maker: 
Mike Cooke (@Wee_Grumphie) and Kevin 
(magpi.cc/diyelectro) 


If you want to run an operating system on Pico, look 
no further than FUZIX. It's a very small version of 
UNIX. It very likely won't replace, well, any of your 
main computers now, but it’s a remarkable feat to 
port it to RP2040. You can find out more about how it 
works, and how to experiment it with yourself, on this 
Raspberry Pi blog post: magpi.cc/fuzix. 


















Temperature 
logger 


Keep track of the temperature in a given location, 
and display the results on a graph. This is great 
for smart thermostats or manually setting times. 


How it works: 

Taking temperature data from a thermistor is 
fairly simple with Python - all you then need 
to do is store that data, preferably in a text 
file. The data from that file is then plotted on 
a graph and displayed on a Pico Display, which 
you can find out how to use from Pimoroni’s 
GitHub: magpi.cc/picodisplay. 


Maker: 
DEW alemsielolmeme Al Loa lekoy VAUD 
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Auxiliary 
keyboard 


Perfectly described by Airton himself: “A mini 
keyboard with Raspberry Pi Pico, it will be my 
hotkey to mute and unmute Zoom, even when I’m 
not on Zoom window.” 


How it works: 

Pico can function as a USB keyboard using C 
and TinyUSB (magpi.cc/tinyusb), or by using 

INV GCenne) saramavoyem@net-t:40) recep en} >).<-a'1 >) MU RMnVOyN.¢s 
ereat with custom keys like Airton used, or with 
something like a Pimoroni RGB Keypad. 


Maker: 


Airton Zanon (@airtonzanon) 
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Sprite rendering 


The Sega Mega Drive did not have Mode-7 style 
eraphical rotation and scaling like the Super 
Nintendo, but that hasn’t stopped James from 
implementing it on a Pico with Pico Display. 

With the transparency, it also goes into Game Boy 
Advance territory. 





Home automation is something Raspberry Pi is great 
t, and we expect to see amazing homes powered = 

s Snes Pico in the near ates ae if it's How it works: 

working with a Raspberry Pi that powers the whole Manipulating sprites like this is far easier than it 

system, Picos can be strategically placed to control was in 1991, especially with Python. You can have it 

individual lights and curtains and garage doors. create a scene that is updated at a specified fraction 
of a second, with different sprites’ position, 
rotation, and transparency updated each time, 
using some simple maths to make it animated. 


Maker: 


IH yd gel an et a i James Sutherland (@jamessutherland) 


Check the temperature and humidity with Raspberry 
Pi Pico. Perfect for green houses, planters, or rooms 
you need to environmentally control. 





How it works: 

This is one is very simple, and in some ways 
Slightly easier than with Raspberry Pi, as Pico 
allows for analogue inputs. With a bit of standard 
code and a nice LCD screen, you can easily convert 
the data coming from a sensor into something you 
can read, like in the photo. 


Maker: 


Caroline Dunn (@thecarolinedunn) 


pana ee eee ee eee 
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Pico robotics 


Using a Pico as the controller for motors in a robot 
means you can skip the motor controller step, and 
reduce down on parts and power. 


How it works: 

Pico supports analogue on some of its pins, so 
with the right code and tweaking you can get it to 
supply the right power to the motors for specific 
tasks. This one is a bit of trial and error, though, 
and we would recommend making use of a motor 
controller until we can get some good code and 
tutorials for this kind of usage. 


Maker: 
Kevin McAleer (@kevsmac) 


Disco lights 


Using a MOSFET switch to power lights that 
require much more power than something like a 
Pico can provide, all in the name of funk. 


How it works: 

A MOSFET is able to control larger currents using 
a small input signal, like how a car starter motor 
works. In this case, for quite powerful lights that 
a Pico, Raspberry Pi, or other microcontroller 
would not be able to power themselves. This 
requires a bit of electronics engineering to get 
right, along with code to activate the right parts 
of the circuit, and Stewart goes into it with his 
video: magpi.cc/picodisco. 


Maker: 
Stewart Watkiss (@stewartwatkiss) 





FEATURE | Mag?i 


Friend of the magazine Stewart Watkiss has been 
doing a lot of work with getting Raspberry Pi 

and Pico to work together - similar to how we've 
written about using Arduino with Raspberry Pi in 
the past! In fact, he’s managed to get Raspberry Pi, 
Pico, and an Arduino working together, as you can 
see in this video: magpi.cc/picoi2c. 


Raspberry Pi Pico 
Voltmeter 
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lol Cricket 


> Things On Edge > magpi.cc/wificricket > £16 / S22 





INPUTS: 

1 x digital, 

1 x digital or 
analogue (8-bit 
resolution), 
wake-up trigger, 
on-board 
temperature 
sensor 


DIMENSIONS: 
37.2 x 16.4 x 
4mm 


WIRELESS 


RANGE: 
Up to 100 
metres 


WIFI: 
2.4GHz 802.11 
b/g/n WPA / 
WPA2 


OPERATING 


VOLTAGE: 
1V-3.5V 


CHIPSET: 
ESP8266EX 
32-bit @160MHz 
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This new British-designed device dims to make building the Internet of 
Things as easy as a few clicks. PJ Evans checks out the no-code approach 





microcontrollers, and Raspberry Pi has 
recently entered the field with Raspberry Pi 
Pico (we’re sure we’ve mentioned it). 

Microcontrollers have many different use 
cases, and this new gizmo from Cambridge-based 
Things On Edge is squarely targeting the Internet 
of Things (IoT) market. The IoT Cricket is a small 
package based on the ubiquitous ESP8266 chipset, 
popular for its solid wireless LAN support. ESP 
microcontrollers are widely available and some can 
be had for just a couple of pounds, so it may come 
as a Surprise to see a British-designed and made 
product introduced to an already saturated market. 
Turns out there are a few things that make this 
device different from the rest. 

The IoT Cricket appears to have been designed 
around the philosophy of ‘do one thing and do it 
well’. At first glance it may not seem like a good 
deal. It’s more expensive than many similar 
controllers and lacks a full range of inputs as seen 


T here’s been a lot of talk recently about 


A The Cricket doesn't feature a wide range of inputs like other 





ESP-class devices, but the size and power consumption make it 
perfect for all kinds of projects 


on Arduino-compatible ESP devices. In fact, the 
IoT Cricket boasts a total of one digital and one 
analogue input and a3.3V output. This simplistic 
approach and some clever design solves one of the 
ereat headaches of ESP-based IoT devices: power. 
By combining a real-time clock into the design 
to control wake-ups as well as a ‘wake up’ line, 

it draws true OA when idle. It can also operate on 
voltages from 1V up to 3.3V. This means you can 
power it from a single AAA battery for potentially 
months, even years, depending on activity. 


Zero-code configuration 

You can’t write code for the IoT Cricket. 
Everything is configured using an on-board web 
interface (there is also an over-the-air solution). 
Placing it into configuration mode (using the 
smallest button we’ve ever seen) starts a wireless 
hot spot that allows you to set the behaviour of 
the device. Options include using the RTC to wake 
the device at given intervals, how to read inputs, 






The lot Cricket appears to 
Nave been designed around 
the philosophy of ‘do one 
thing and co It well’ 


and also what to do with the data. IoT Crickets 
support MQTT and HTTP GET or POST actions, 
making them instantly compatible with a huge 
range of monitoring and alerting services. Things 
On Edge even provides a free MQTT broker if you 
don’t want to set up your own. 

Programming microcontrollers is not for 
everyone (especially if you’re using C), so this novel 
approach of configuring the IoT Cricket places the 
Internet of Things within the reach of a much wider 
audience. Even if you are accustomed to coding ESP 
devices, getting a simple project up and running 
with this approach is much quicker. 

Things On Edge has provided several examples 
of projects using the IoT Cricket, including 
door sensors, wireless light controllers, motion 


cSt hi ings OnEdge 


Dashboard Canfig Bind rig Info U pyrace chy 


device status UPDATED 


type 
url 
user 


password 


on/off 
unit 





detection, and more. There is also considerable 
documentation on integrating with services such as 
IFTTT and Home Assistant. They’ve even included 
an on-board temperature sensor (TMP1075DSG) so 
you can get started with no soldering. The online 
documentation can be a little hard to wade through, 
but seems to be constantly improving. All in all, 

it’s avery impressive device if you want ultra-low 
power consumption and very easy setup. Hl 


lol Cricket 


| MagPi 


The loT Cricket is small, 
elegant, and perfect 
for single-purpose use 


You can configure the 
lol Cricket through its 
web interface, even 
remotely using its 
OTA feature 


Verdict 


If you're not 

into coding, or 
are looking for 
devices that 
could truly 

last years on 
batteries, this 
might be the 
smoothest route 
to your own loT 
utopia. Cheaper 
options are 
available, but 
none is this easy 
to use. 
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Pico Explorer Base 





DISPLAY:: 
1.54-inch IPS 
LCD screen, 


240x240 pixels 


FEATURES: 
170-point 
breadboard; 
breakout 
header 
including 

l2C, SPI, ADC; 
dual H-bridge 
DW8833 
motor driver; 
2 x Breakout 
Garden |l2C 
sockets; 4 x 
tactile buttons 


DIMENSIONS: 


117x63x20mm 


~ Connect ajumper wire 


from a GP female pin to 
the Audio pin to send 
sound to the on-board 
piezo speaker 


> Pimoroni » magpi.cc/picoexplorer 


m £22 /S26 


Experiment with electronics and a mini display with this 
add-on board for Raspberry Pi Pico. By Phil King 


raft of add-ons created for the tiny, but 
powerful, microcontroller board. The 
Pico Explorer Base is one of the most interesting 
offerings, enabling you to plug and play with 
standard electronic components to explore 
physical computing more easily. It also has the 
bonus of a mini LCD display, dual H-bridge motor 
driver, and a couple of breakout slots. 
To use the Explorer Base, your Pico will need 
to have male pin headers soldered, facing 
downwards - if you don’t fancy doing this 
yourself, it’s possible to buy Pico boards with pre- 
soldered pins. It’s then just a case of mounting 
your Pico in the dual female headers; a helpful 
‘landing area’ graphic on the Explorer Base 
indicates which way round to place it. 


T he launch of Raspberry Pi Pico saw a whole 


Making connections 
On the left side of the Explorer Base is a mini 
ereen breadboard with 170 points. While this 


Ao: 
= | a 


PLUG H JUMPER WIFE 
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may prove a little cramped for some projects, you 
could always just use a separate breadboard to 
house extra components. Note that no electronic 
components are supplied with the board, so it’s 
up to you to source your own LEDs, buttons, 
sensors, etc., along with the male-to-male 
jumper wires to connect them. 

Rather than wiring components to Pico’s pins 
directly, a selection of its pins are broken out 
via two 12-pin female headers. These are clearly 
labelled and include I2C, SPI, ADC, and seven 
standard GP pins. While there are two GND 
connections, the only power option is 3V3, so this 
rules out any components requiring 5 V power, 
such as NeoPixels. An Audio pin is connected to 
the on-board piezo speaker. 

The remaining four breakout pins are allocated 
to motor connections. Making use of a DRV8833 
dual H-bridge motor driver chip, these can 
deliver 1.5A RMS current output to control two 
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hows 
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M Plug and play with standard 


electronic components to 
explore physical computing 
more easily @ 


DC motors (or other power-hungry devices 
such as bright LEDs) - there’s even a handy 
overcurrent warning LED next to them. 


Mini display 
One of the highlights of the Explorer Base is the 
mini LCD screen on its right-hand side. This 1.54- 
inch, 240240 IPS display is vibrant and useful 
for showing data such as sensor readings, as well 
eraphs, text, and colourful graphics. Like most 
of Pimoroni’s mini displays, it features four tiny 
tactile buttons around the outside for user input. 
You could even use them to play simple games. 
Above the screen are a couple of five-pin 
[2C-based breakout slots that are compatible 
with Pimoroni’s large range of Breakout Garden 
boards. Making use of them isn’t quite so simple, 
however, since the Explorer Base’s supporting 
software libraries — for C and MicroPython — are 
still a work in progress at the time of writing, 
and only include drivers for a few breakouts. 
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Pimoroni tells us more will be made available 
soon. With a great deal of jiggery-pokery, and 
the help of a CircuitPython bus conversion 
library (magpi.cc/cpbusdevice) created by Ben 
Everard from our sister magazine HackSpace - 
we managed to get a BME68o breakout sensor 
working in MicroPython. Note that you’|l also 
need to flash Pimoroni’s custom UF2 firmware to 
Pico to use the Explorer Base with MicroPython. 
Driving the LCD display and reading its 
buttons is made fairly simple by a MicroPython 
module. This enables you to set pixels, create 
filled rectangles and circles, change pen colours, 
and display text strings and characters (using 
a preset upper-case font). With a bit of effort, 
it’s possible to create some more advanced 
effects, such as lines, hollow shapes, and even 
scrolling text on a path — as demonstrated by 
Tony Goodhew in his excellent Instructable 
(magpi.cc/explorerworkout), which shows the 
power of the display and Pico itself. Hl 
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A. Packed with features, 


the Pico Explorer 

Base Is billed as 

an ‘electronic 
adventure playground’ 


Connect components 
on the breadboard to 
the clearly labelled 
female breakout 
headers. Pico's USB 
connection also powers 
the Explorer Base 





Verdict 


While the software 
library support and 
documentation is 
currently lacking, 
and may prove 
befuddling for 
beginners, the 
Pico Explorer Base 
packs in a lot of 
functionality to 
explore physical 
computing 

with Pico. 


8 i 





Pico Explorer Base | magpicc | 81 


WS MagPi | REVIEW 


10 Amazing: Sl : 


MakerBot feoicoatey 
Make [ 4 3D printer 
Print your dreams 
C) C) S A quite expensive item for sure, but one that has endless possibilities. Thanks 
to online modelling communities and easy access to basic CAD software, you 


can quickly prototype and test designs for projects, or create that part you can't 
get elsewhere. 





Help make your dreams a reality 
with the right set of tools 


«Wire stripper 


ractice and experience is generally more 

important than the tools you have for the job. 

However, the right tools can make it easier, 
whatever your level of experience. A well-stocked 
workshop can really help bring your projects to life — 
here are ten tools we think you should have. 


No knife required 


Snipping wires to length is easy; removing the plastic 
insulation to reveal the actual conductive wire 
underneath can be a little tricky. We recommend a 
good wire stripper, especially when you get past the 
breadboard prototyping phase. 





> Glue gun 


Hot fusion 






Easy to apply, quick to set, strong, and 
insulating? Glue guns are a maker's best 
friend. Always make sure to get one with at 
least two settings, though. And don't rely 
on just one for all your gluing needs. You 
can even get sealing wax sticks for them, 
as well. 





> Cutting mat 





A Helping hands Precision slicing 
—— While you can cut on the surface of a 
Handy holders wooden workbench in a pinch (and with 
permission), a cutting mat is definitely the 
Due to various reasons, humans have two hands. Sometimes preferred method. It won't dull the blade 
less. Balancing wires and solder and a (very hot) soldering iron, as much, they self-heal, and they usually 
or holding a small piece steady painting, can be tricky even for come with angles and measuring tools 
the most dextrous. With movable clamps and a magnifying glass, built onto the surface so you can have a 
helping hands make it easier for everyone. better visual guide. 
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4 Rotary multi-tool 


Spinning trimmer 


Otherwise known as a Dremel, which is a brand of tool maker that makes 
popular rotary tools, they're great for small projects. You can sand, buff, cut, 
drill, shave, and more by switching out the different tool heads. It’s great for 
makers as they're small and cover a lot of bases. 






> Directional light 


See your project 


It's easy to find little USB LED lights 
on a goose neck these days. They're 
bright, low energy, can be clamped to 
a table, and moved around however 
you wish. For finer work, good 
illumination is key, and they're a bit 
more flexible than a head torch. 


v Needle-nose pliers 


Grab small things 


You never realise just how much you need a slim pair of pliers until you really 
need them and all you have are tweezers or heavy-duty pliers bigger than a 
Raspberry Pi. Of course, a good set of tweezers and regular-sized pliers are 
great to have as well. 
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4 Soldering iron 


Create circuits 


An essential tool for electronics, a soldering iron is basically a 
very hot metal pen that allows you to melt specially treated, soft 
metal that allows for wires and circuits to be connected and have 
electricity run through them. Make sure to tin the tip before using, 
though: magpi.cc/ tin. 





a Clamps/vice 


Steady on 


Vital for a lot of wood- and metalwork - even some painting! A 
clamp can keep your projects sturdy so that drilling or cutting 
won't go awry, or make sure glue will dry firmly, or even make 
sure metal is aligned for welding. Got a miniature with a base? You 
can lightly clamp it in one to keep it steady too. 





Safety gear! 


Every good maker knows they need safety equipment. Dust 
masks, goggles, welding mask, sturdy gloves, and even a 

good set of coveralls are a good idea as well. Before you do 
any making, make sure you're doing it as safely as possible. 
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Learn ARM assembly 
with Raspberry P1 


Get down to the metal by learning ARM assembly language. By Lucy Hattersley 





Introduction to ARM 
assembly basics 


Maria 
Markstedter, 
Azeria Labs 





Price: 
Free 


magpi.cc/ 
azeriaassembly 


Assembly is a low-level 
language sitting just next to 
machine code. It’s also known 
as ‘symbolic machine code’ 
because assembly statements are 
typically translated directly into 
their machine code counterparts. 
Assembly is more readable 
than entering pure hexadecimal 
or binary code, and you get 
the benefit of comments and 
symbolic jump locations. Even 
so, it’s not for the faint of heart. 
Assembly is as close to bare- 


metal programming as you are 


likely to get. It’s cryptic in nature 
and you’re unlikely to ever create 


an app, web Service, or even 
useful program in assembly. 
Instead, this is all about the 
purity of learning. 

Azeria Labs’ website has a 


starter course in ARM assembly 


as a preparation for a much 


more detailed course on exploits. 


Created by Maria Markstedter 


(@Foxox0o1), the course is split 


into seven parts, and covers 


Hello Assembler 





These tutorials will help you get started 
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ARM ASSEMBLY 

HELLO WORLD 

The classic doing introduction 

is covered in this online tutorial. 
Discover how to write and compile 
‘Hello World’ in ARM assembly. 
magpi.cc/helloarm 


ARM ASSEMBLER IN 
RASPBERRY PI 

Think in Geek's tutorial is worth 
bookmarking, but Chapter 1 takes 





the ARM-based assembly 
environment, data types, 
registers, the instruction set, load 
and store, conditional executions, 
stack, and functions. 


you through writing and compiling 
binary code on Raspberry Pi and 
creating a ‘makefile’. 
magpi.cc/thinkingeek 


PROGRAM IN ARM6 ASSEMBLY 
LANGUAGE ON A RASPBERRY PI 
This great tutorial by Marty Kalin 
features a walkthrough of the 
hailstone function, first in C and then 
in ARM assembly. 
magpi.cc/programarm6 





William Hohl, 
Christopher 
Hinds 





Price: 
£85 / $110 


magpi.cc/ 
assemblyfundamentals 





Robert G 
Plantz 





Price: 
Free 


magpi.cc/ 
introcomporg 


ARM Assembly Language 
Fundamentals 


Hohl and Hinds’s book is a 
widely regarded classic on 
the subject of ARM assembly 
language. It’s also a good 
introduction to computing in 
a broader context, starting 


ARM ASSEMBLY 





Introduction to Computer 
Organization 


Robert G Plantz’s book, 
available for free on the Sonoma 
State University website, isa 
solid overview of ARM assembly 
language, interspersed with 
exercises to flex your mental 
muscles. Each exercise has hints 
and full solutions to help you 
keep moving along. 

The course covers data, 
arithmetic, algebra, logic gates, 
circuits, and a crash course in 
CPU architecture before you 
even start on ARM assembly. At 
which point you get a thorough 
grounding in compiling assembly 
language and in an in-depth 
analysis of every feature. This is 


with an overview of computer 
architecture and history. 

This is a complete 
introduction to assembly 
language over 18 chapters. There 
are detailed introductions to 
the instruction sets, assembler 
rules, loads, constants, logic and 
arithmetic. It works into more 
detailed areas, such as floating 
point instructions, exception 
handling, and memory mapped 
peripherals. The final chapter 
shows you how to mix C and 
assembly together. The sticking 
point is the retail price of the 
book: quality costs. However, 
you can pick up a digital edition 
for less, and we have found it on 
sale at various outlets. Or, you 
can pick up a second-hand copy 
for roughly half the price. 


one of the most detailed courses 
around, and the bonus that it is 
written directly for Raspberry Pi 
ensures you are likely to stay on 
point. And getting it all for free 
is remarkable. H 


RESOURCES | Mag?i 


PN EXomeyi 


interest... 





Bookmark these 
resources 


ARM DEVELOPER 

ARM has a wealth of 
documentation available, 
including programmers’ 
guides and reference 
documentation. It can be a 
little detailed for the beginner, 
but bookmark it for when you 
start asking questions. 
developer.arm.com 


RASPBERRY PI SOC 
DATASHEETS 

Raspberry Pi’s system-on-chip 
datasheets are a good way to 
understand how Raspberry 

Pi hardware implements with 
ARM SoC. 
magpi.cc/socdatasheets 


ARM REFERENCE CARD 
This ARMv7 cheat sheet from 
the ARM documentation 
website is a great PDF to 
download and print out.. 
magpi.cc/armcheatsheet 


+ ef © = 


Introduction to Computer Organization: ARM Assembly 
Language Using the Raspberry Pi 
Roteert & Flam 
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PML rep RRR Ph CREE DT: Gd I a ey LOE Ce 
m, Pore eto ce beh 


eer nore er 


i Beet 


Purerrird, Prensa der ye peers 


rican, Spare? pote fiene of ib Bur 


iy i ere De pombe on pes 
Oe rat ke paar ge nar Me eae berg 


Pre area doe) ed ce Go pe er ore pT, a 
Bey UML 





i 
luo 
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EE agri | INTERVIEW 





V_ Kevin's job is to make sure 
this mission statement is 
made reality 





Kevin Johnson 


A man of many talents, Kevin helps to organise 
official Raspberry P| events and produce free resources 


> Name KevinJohnson | 


> Community role Event runner 





community for Raspberry Pi 

in North America, and have 
been to one of the many events 
the Raspberry Pi Foundation 
North America (RPFNA) has 
organised, you’ve likely got 
Kevin Johnson to thank. If 
you’ve ever met him, you’ll 
know he loves doing it, and we 
love him for it. 

“So my official title is Club 

Programs Coordinator,” Kevin 
tells us. “What that means is 


f you’re part of the 
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> Occupation Coding club liaison 


| »>URL @KJberrypi 


I help develop engagement 
Strategies and also implement 
them to keep our youth 
programs community (Code 
Club, CoderDojo, Coolest 
Projects) in the USA fully 
immersed in all of the free 
resources we have. It involves 
a lot of writing, which I love 
because my background is in 
creative writing, so I write 
monthly newsletters and blogs, 
I design seasonal competitions 
for young people to participate 





in, | try to maintain our 
presence on social media, anda 
bunch of other things. I’m truly 
a wearer of many hats!” 


What did you know about 
Raspberry Pi before joining? 
Full transparency, | did not 
know much about Raspberry Pi 
prior to joining the Foundation 
because my introduction to tech 
was mainly focused in Adobe 
Creative Suite programs like 
Photoshop, Illustrator, Premier 
Pro, etc. I was in a multimedia 
academy (CMMA) in high 
school, so I dabbled a little bit 
with coding, but not enough 

to know about the different 
hardware out there. My 
knowledge of Raspberry Pi came 
when I discovered the job listing 
and after reading through 

the Code Club and CoderDojo 
blogs, I was immediately 
hooked. To see such a small 
device have such a large impact 
on people all over the world, 
especially people from different 
socioeconomic backgrounds, 

I had to have the job. Fast- 
forward two years and here | 
am, still loving every minute! 





What are some of your 
favourite moments with the 
Raspberry Pi community? 

I had a blast co-hosting last 
year’s Coolest Projects USA 
event that we held in Santa Ana, 
CA at the Discovery Cube Orange 
County! I love the energy that 
young people bring to any space 
and in that space the energy 
was at an all-time high. Also, 


| had a blast 
co-hosting last 
year's Coolest 
Projects USA 


who hasn’t dreamed of being a 
talk show host?! If you can get 
on a Stage and keep a group of 
young people entertained and 
laughing, it’s a great sign that 
you’re doing alright in life. I 
have to also mention the few 
trips our team here in the USA 
have taken to Cambridge to visit 
the Foundation headquarters; 
those have been some of 

the greatest moments of my 
life! Being part of a global 
community, learning about 


other cultures, connecting with 
colleagues on a more personal 
level is just amazing. It means 
the world to me to work for 

a global organisation that 

finds importance in bringing 
its employees together not 

just to work, but to also play 
and have fun. 


What are some of your 
favourite moments with the 
Raspberry Pi community? 
We’re really excited about this 
year’s Coolest Projects event, 
especially because this will be 
a global event where we will 
hold one event for all of our 
participating regions. Here 

in the USA, we were lucky 

to be able to have the event 
in-person right before the 
lockdowns started last year, so 
while we did get to experience 
that, we did not get to 
experience the event online like 
everyone else. Collaborating 
with the global team on the 
upcoming Coolest Projects 
Online has birthed some really 
awesome ideas that we can’t 
wait to share with everyone 
come early June when this 
year’s showcase happens! 





MagPi 


Coolest Projects USA is a 
huge event which Kevin not 
only co-hosted, but he was 
also one of the organisers 


Kevin helps Code Clubs and 
CoderDojos around the country to 
make sure they're up-to-date with 
all the latest projects 





i 


You'll see Kevin helping out at just about every 
event in the US, and some elsewhere in the world! 





Share your stories 


“As a Storyteller, | love telling stories of my own, but | 

also love sharing the stories of others, so please connect 
with me on Twitter at @KJberryPi or through email at 
kevin,jjohnson@raspberrypi.org if you have a story that you'd 
like to share! Community is everything to me, so it brings me 
so much joy to share the stories of our global community!” 


Kevin Johnson magpi.cc 
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This Month in 
Raspberry P1 


#MonthOfMaking 
on Mondays 


Amazing projects direct from our Twitter! 












B se 


What's about a Pi zero based smart glass Fe 


+: Are or | May oe 
TMianthithakinga 







very Monday we ask the question: have you 

made something with a Raspberry Pi over 

the weekend? Every Monday, our followers 
send us amazing photos and videos of the things 
they’ve made, especially during #MonthOfMaking. 

Here’s a selection of some of the awesome 

things we got sent this month - and remember to 
follow along at the hashtag #MagPiMonday! 





01. Smart glasses are very cool, and we're 
looking forward to seeing what Arjit does 


02. Anice little fitness tracker 


03. Askill that many of us on the mag f orenemcelsinah 
would like to learn ; 

Took a fair bit of hacking, but Built a Pi Zero eink mini 

info radiator, with my Strava year so far. | really miss 

SWIMM ng. 





04. Load up Xanadu on the fake vinyl 


05. #MonthOfMaking is for more than just 
Raspberry Pi stuff, as Alex shows here! 


06. We're not 100% sure this watering can 
would work well with water 


07. Ambient info/art is a cool idea. Ours 
would frown depending how close to 
deadline we are! 


08. We like seeing Jitesh's robot 
develop further! 


09. Easy, yet a cool thing to learn thanks to 
a bit of clever Python code 


10. Avery fast robot indeed, and custom 
as well! 
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alex jirassic 


ee 2 Parse 





e. 


For #MonthOfMaking | decided to start a whole side 
business making and selling #*DungeonsandDragons 
gifts on @Etsy. I've had some great sales and feedback 
for these Potions of Healing and can't wait to design 
more! etsy.com/uk/listing/974 






| made this, now | just need to learn how to play piano 






#MVonthOtMaking 







Welcome to my musical piano stool, Korg Monotron using #RaspberyPi and 
MOPd?25 DAC as MIDI to CY converter, 
Fetes thag guide Ey Gryaekerar schdlicom res pberry pais... 


hiark Cantrill 
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Teohing ta @ Thelagk 






Another step closer to completion of the Raspberry Pi 
Jukebox, this time with rattles, clicks, whirrs and toons... 









a 
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“ill Pica Fa sie: 


| haven't planned my March make yet burt... 


Made a human following robot using Raspberry Pi, 
PiCamera, a Pre-trained Object Detection 

#MachineLearning model, #Tensorflow Lite and Coral 
USE Accelerator 





At the weekend | completed my @ikaspberry Pi Pica 
watering can 


+b 5 Lam party iy ia a a 1 ke fe 
themakercupboard.space/index.php/?0e 1.. 












Read the article:- 


hellowerld.co.in/article‘ai-roab 









Video: - 


Youtu,. be/GSYtnSBIGB 






| Mike Fell 


Rpr a fe 







#manthoafmakin q 






Inspired by ‘@openbookuk's eink electricity display 
from a week ago 
















DD Mike Fell grrtietonay - oa 
Experimenting with ambient infoyart this weekend. Tis portralt stamcis in my 
kitchen and smiles frowns depending on cument level of renewable generation 
via Gog eso) and octopus energy Agile price. Uses a GiRaspbeny_Pi Zeno and 
eepowenéed Gipirmandal eink citplay 











rus Of 


6) Robert Kelee 


Probably the easiest make ever. PiZero + old weba 
Motioneyeos software, Pushover App and a python 
script from MagPpi magazine and hey presto a cat 

detection system up and running *moanthofmaking 





@) Dr Footleg - Roboteer 
Reolving to sbHackSnarehts 


| made a new Raspberry Pi based robot! 
#MonthOfMaking 











@ Dr Footleg - Roboteer @driootleg «Mar 1 
It iS firaéhed! Showdaéed on the @Prestoanklam tonight. My Turbe 4D. It's really 
fast, and powered by my own designed electronics. 
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Coolest _ 
Projects online! 


Submit your projects for the next Coolest Projects 
online showcase before Monday 3 May! 





a lot of other events. [t went so well it’s 

happening again this year, and you can take 
part! No matter where you live, as long as you’re 18 
or under, you can apply! Here’s what CoderDojo has 
to say about it... 

“We welcome all projects, all experience levels, 
and all kinds of projects, from the very first Scratch 
animation to a robot with machine learning 
capacity! The beauty of Coolest Projects is in the 
diversity of what the young tech creators make. 

“Young people can register projects in six 
categories: Hardware, Scratch, Mobile Apps, Thinking about entering but not sure how? 
Websites, Games, and Advanced Programming. There’s a fantastic video (magpi.cc/cpregistervid) 
Projects need to be fully registered by Monday 3 May and even a worksheet (magpi.cc/cpworksheet) that 
2021, but they don’t need to be finished then — at will get you ready for it. 

Coolest Projects we celebrate works in progress just Once you’ve figured out a project, head over to 
as much as finished creations!” magpi.cc/coolestprojects21 to register. Good luck! H 


REGISTER 


ast year, Coolest Projects went online like 





PROEC 


St, DEADLINE 
pROJECTS. «= J MAY 9:00 BST 


4 FECODLESTPROUECTS | COOLESTPROJECTS. ORG 


wT oe 
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Crowdfund this! 22272 Yy Y 









CarPlay and Android Auto 


on Raspberry Pi 128 Opto-isolated Inputs 


plus RS485 


If you have a car that hooks up to your phone for better 
navigation and a car-friendly UI, you'll Know how good it 


can be. This Kickstarter is to help develop further some If you need to read a lot of digital inputs on a Raspberry 
software called OpenAuto Pro so that it can plug into Pi, and the GPIO pins just aren't enough, this big HAT- 
the Apple CarPlay and Android Auto API so you use it on style add-on might be the solution. It has already hit 
Raspberry Pi. A very interesting prospect. its funding goal, so is definitely worth a look. 

» kck.st/3k6KDVa » kck.st/3aA2T6j 


Best of the rest! 


Other amazing things from the community 


AUTOMATIC WATER DISPENSER | RASPBERRY PI 3D SCAN | ANALOGUE BANDWIDTH GAUGE 
We've seen computer vision used before to A 3D model of a Raspberry Pi that was An old DC voltmeter has been upcycled with a 
grade cucumbers, but to make sure a water created by a 3D scanner powered by a Raspberry Pi Zero W to show the bandwidth in 
bottle is safely filled with the right amount of Raspberry Pi. This is an amazing result, user jllauser's home network. It's very fancy. 
water is excellent. We like the little light display and we're glad to see 3D scanners have 

that speeds up as the bottle is nearly full. improved so much over the last few years. 






2 . 
=) i 
ie. 
tT 


- =] 
ae 
ot ee ee 


ee 
eee 





33 


> magpi.cc/awdispenser > magpi.cc/diy3dscan 


Vv 


magpi.cc/bwgauge 
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Your & 


Letters 








I donated to the Raspberry Pi Foundation for Pi Day 
and I learned later that my name might end up in the 
magazine. Which issue should I be looking out for? I’ve 
read your magazine for years and would love seeing my 
name in it! 


Sylvia via Facebook 


Due to the timing of how The MagPi is produced, 
unfortunately we couldn’t make it happen in this issue. 
However, we’ll be making sure it gets printed in issue 105 
- check out page 97 to see when it comes out. 


o Hardware Software figakiEimageting: Laam Teith sbi ie 


Donate 


You 207 empievrel yourkg pesste welds Lo lean Goerpuling 
and become confiiesdl, creatiee Gage! maces, 


From now uirvtdl 14 Hanch. your donate will ge-towarnd our spacial 
PLOY ceeeupn. Your gif will gemnade young leerners with access. 
Bo Gur fun, free colin Sodiney and dagital making prota 





I would like ta make a 


GB) One-time domation (2) Monthy donation 


a] Cm 














A The Raspberry Pi Foundation is a non-profit charity, so every little helps 
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V Rafa used an old notebook as a screen for a desktop Raspberry Pi setup 





_— 


#MonthOtMaking email 


I emailed you details and photos of my #MonthOfMaking project, 
but just read in the magazine that they should be posted on 
Instagram and Twitter. I don’t have either of those. Will my 
project not be counted? 

Rafa vid email 


It still counts! You still made something, and we will put it in the 
magazine when we do a full #MonthOfMaking roundup next issue. 
We think it’s great to post it on social media so other folks might be 
inspired to make something. 

If you have a project you’d like to share with us, you can always 
email us any time of year. 
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V You can get PDFs of all our issues from magpi.cc/issues 
5 
Back Issues Clidalele EPO 


I was looking at your GitHub and noticed not all the 








MEDIA GEHXTRE Bari the Winnie rch contin i The Tie beat Pari i a0 preci are code iS available in repositories, some of it iS in a zip 
Magri maiqurina bere Pio. Sipe Guities! Learn code) and cornet aah e ‘si é ‘ 
mene eel nse: ly pares and are your new alone cele Phas eg file. Why not just have the code in the issue repo? 
with Rai pieecty Pi Caar Guaichy declan Peeper Le a npins Do ey akiek: coe a CUE ard pi- 
isineled jureglan at maa Bune cles ot lll bogs FRG Trash Seren decd Poel otk 
fone cits Foyt s : H 
Mone cists Daniel via GitHub 
Issue 100  [ssue 99 There are a couple of different reasons for why this is: 
Puxuerie oe — Berar pea 5 P : A 
2 when we Started putting code on GitHub, it only included 
The Magri magacing: be Oc iscueet young T Ciscower an endless aay of amazing 
OFTHE EN Les a ood vein this: . ais, Geeice, and prokects wilh our + + 
Se a ge Becks tia poke gan eenctha the code that would only live on that repository. All the 
chiles lee tiaheleid anedaectll gates ibe rae iret Pye ester repos are linked from The MagPi article they appear in, so 
P Mate Sets . . . : 
Mw oti my Mike Cook’s work appears on his Pi Bakery GitHub. 
Someone asked us if we could provide all of this code 
lesue 98 leeye 97 for the mag as a Zip as well, so we started doing that and 
—-™ "pair wad uploading it with any other code that needed a repo. 
ae | Diicever Reapivery Pi peetable computing - os 70 Painting & Rink in The bine o7 é ‘ 
nthe Lotees! chtien of The Migr. irik ee) Chacon WO priatliey. Wier cali, arc We have NOW started to provide a link to the other 
Thag leg reg parimiy eres Eau peor lato J Grit lochguars. nd) eo a eT . 7 7 2 . 
[] computer Cade on-the-go with the SBME Raspberry Fike repositories in each issue’s repo now. As we figured 
Rashes ty Pi 20 Deorinole vaorke . . fore petits . ; ; 
seerneteer SD (oo cons people would be going from the article to the repo, it 
a | Frnt Downoad | : 





didn’t occur to us to put a link there. Now they are! 


Out of stock Books . oe he ES 


gg eobahesg Wigt seruric fogd on dT Jen Qs} loot 


I was looking over the list of books you’ve released and noticed 


Be Pepentrgres 


that some that I wanted were out of stock. When will they return to C Nagrintzsecene 
the store? 0 RADMEmd 
Ibs vid email resomens ; 
Repository tor onde featured in The Magri 12 
Some books take a little longer to restock than others, although some a ay AES ee eo 
may not see a print run again. However, all the books we’ve released aint bet py ees ages imc 


lank 86 neseneriery fer “Fccied face eogrrhe Abe pou? pregcin wth Popapepery PY: hariag wthuble 


are available as a free PDF which you can print (or get printed) 
yourself if you need a physical copy. 
There are probably some knocking around on eBay as well. 


Link 86 reSperiory dor Cae Tile foe al? mages ce peu lary 


A Need a hub for all the code in an issue? 
Our GitHub will have it 


Contact us! 


> Twitter ©@TheMagPi 


> Facebook magpi.cc/facebook 
> Email magpi@raspberrypi.com 
> Online raspberrypi.org/forums 
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SMARTIPI TOUCH 
PRO CASES! 


IN ASSOCIATION 
WITH SmartiPi 


We reviewed the SmartiPi Touch Pro In 





XN 









the last issue of The MagPi and gave It a 
phenomenal 9/10. If you're still not Sure If 
you want one, maybe we can tempt you 
with a competition to win your very own? 





Head here to enter: magpi.cc/win | Learn more: magpi.cc/smartipi 





Terms & Conditions 


Competition opens on 24 March 2021 and closes on 29 April 2021. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, the 
prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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Gaming's harshest, most Team BINJA sharpens up The growing role of video 


exhilarating mechanic iS action RPG franchise games in the classraoam 
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Running up that hill 


How patience can be its own reward, By Lucy Hattersley 


omputers are truly wonderful 
C inventions. The miracle of the 
modern age, as some would 
say. But it’s fair to say they can also 
be opaque. While it’s easy to look at 
a clock or a Steam train and see the 
moving parts, the ‘micro’ part of a 
microcomputer means you have to use 
a very powerful microscope — or, more 
likely, your imagination — to see the 
moving parts. 

There are billions of bits shifting 
thousands of times per second. The 
act of teaching a rock to think is 
rather overwhelming for our small 
Simian brains. 

Learning computer architecture is a 
task worthy of Sisyphus, only you are 
carrying a rock that frequently crashes 
and stalls as you carry it up to the 
mountain of understanding. Advances 
in artificial intelligence ensure that it’ ll 
be soon giving you lip on the way up. 


Carry on coding 
Let’s look on the bright side. One way 
in which the last few months have 
been positive for me is regarding 
concentration. With everything 
closed, I’ve been able to sit down and 
focus on a few things. 

Learning about low-level 
computing, right down at the 
mechanical level is one of them. And 
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it has been tough going. It requires a 

clear head and a steady concentration. 

I’ve also learned a new level of 

meaning to the word ‘perseverance’. 
This isn’t the first time I’ve tried 

to understand low-level computing. 

I first got the coding bug when | was 

very young: introduced to a ZX-81 in 

pre-school and then working my way 


know what’s going on when I switch on 
my Raspberry Pi. (Always handy when 
you do that for a living.) 

Ive been using a Raspberry Pi 400 
to work through the course materials, 
and the experience is surprisingly 
similar to the ZX Spectrum of my 
youth — although the keyboard is 
infinitely better, as is the operating 


M Learning computer architecture Is a task 
worthy of Sisyphus, only you gre carrying a 
rock that freguently crashes @ 


through the BBC Micro at school and 
a ZX Spectrum (then Commodore 64) 
at home. 

For all the coding tricks I’ve learned 
over the years, it’s always saddened 
me that I didn’t quite get the hang of 
Z80 machine code when I was young. 
For some reason, I just couldn’t get 
any of my Z8o code to work and 
eventually I moved on. 

Lately, ve been working my way 
through the Nand2Tetris course 
(nand2tetris.org), partly as an attempt 
to get back to those binary and machine 
code roots so that I can at least get my 
head around Z8o coding as a present to 
my younger self. Also, to get a better 
understanding of ARM architecture so I 


system. I’ve also got a new Raspberry 
Pi Pico hooked up to the back, just like 
an expansion card. 

Hopefully, Pll carry this Nand2Tetris 
rock to the top of the hill. And 1 
suspect I will roll it down at the 
end and reveal something new to 
learn. There’s always a shiny new 
technological concept waiting to be 
discovered. Onwards and upwards! Hl 


Lucy Hattersley 





Lucy is editor of The MagPi and recently 
learned how to burst a water pipe with a 
drill. Look carefully, kids. Look, then drill. In 
that order. Every day is a school day! 
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e Displays e Cases e Project Kits e Add-on Boards 
e HATs e Arcade e@Cameras e Cables and Connectors 
e Sensors ® Swag e Power Options e GPIO and Prototyping 


Partner and official reseller for top Pi brands: 
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RO oMM (ecm mae) o)(eMe)celneiayie)iare 
with your Raspberry Pi 


Power your projects with computer vision and applied AI 


pi-top [4] Robotics Kit comes with electronic components such as a wide-angle 
camera, servos and motors, all of which plug and play with the pi-top [4] 
Complete or pi-top [4] DIY Edition’. 





pi-top Robotics Kit with Expansion Plate 


187.90 / $199.90 
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Raspberry Pi is a trademark of the Raspberry Pi Foundation. tpi-top [4] and Robotics Kit with Expansion Plate sold separately. © CEED Ltd. 2021 


Raspberry Pi made simple, robust and modular. 





